261 lines
9.5 KiB
Protocol Buffer
261 lines
9.5 KiB
Protocol Buffer
/*
|
|
Copyright 2017 The Kubernetes Authors.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
|
|
// This file was autogenerated by go-to-protobuf. Do not edit it manually!
|
|
|
|
syntax = 'proto2';
|
|
|
|
package k8s.io.api.admissionregistration.v1beta1;
|
|
|
|
import "k8s.io/api/core/v1/generated.proto";
|
|
import "k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1beta1/generated.proto";
|
|
import "k8s.io/apimachinery/pkg/apis/meta/v1/generated.proto";
|
|
import "k8s.io/apimachinery/pkg/runtime/generated.proto";
|
|
import "k8s.io/apimachinery/pkg/runtime/schema/generated.proto";
|
|
import "k8s.io/apimachinery/pkg/util/intstr/generated.proto";
|
|
|
|
// Package-wide variables from generator "generated".
|
|
option go_package = "v1beta1";
|
|
|
|
// MutatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and may change the object.
|
|
message MutatingWebhookConfiguration {
|
|
// Standard object metadata; More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata.
|
|
// +optional
|
|
optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
|
|
|
|
// Webhooks is a list of webhooks and the affected resources and operations.
|
|
// +optional
|
|
// +patchMergeKey=name
|
|
// +patchStrategy=merge
|
|
repeated Webhook Webhooks = 2;
|
|
}
|
|
|
|
// MutatingWebhookConfigurationList is a list of MutatingWebhookConfiguration.
|
|
message MutatingWebhookConfigurationList {
|
|
// Standard list metadata.
|
|
// More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds
|
|
// +optional
|
|
optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1;
|
|
|
|
// List of MutatingWebhookConfiguration.
|
|
repeated MutatingWebhookConfiguration items = 2;
|
|
}
|
|
|
|
// Rule is a tuple of APIGroups, APIVersion, and Resources.It is recommended
|
|
// to make sure that all the tuple expansions are valid.
|
|
message Rule {
|
|
// APIGroups is the API groups the resources belong to. '*' is all groups.
|
|
// If '*' is present, the length of the slice must be one.
|
|
// Required.
|
|
repeated string apiGroups = 1;
|
|
|
|
// APIVersions is the API versions the resources belong to. '*' is all versions.
|
|
// If '*' is present, the length of the slice must be one.
|
|
// Required.
|
|
repeated string apiVersions = 2;
|
|
|
|
// Resources is a list of resources this rule applies to.
|
|
//
|
|
// For example:
|
|
// 'pods' means pods.
|
|
// 'pods/log' means the log subresource of pods.
|
|
// '*' means all resources, but not subresources.
|
|
// 'pods/*' means all subresources of pods.
|
|
// '*/scale' means all scale subresources.
|
|
// '*/*' means all resources and their subresources.
|
|
//
|
|
// If wildcard is present, the validation rule will ensure resources do not
|
|
// overlap with each other.
|
|
//
|
|
// Depending on the enclosing object, subresources might not be allowed.
|
|
// Required.
|
|
repeated string resources = 3;
|
|
}
|
|
|
|
// RuleWithOperations is a tuple of Operations and Resources. It is recommended to make
|
|
// sure that all the tuple expansions are valid.
|
|
message RuleWithOperations {
|
|
// Operations is the operations the admission hook cares about - CREATE, UPDATE, or *
|
|
// for all operations.
|
|
// If '*' is present, the length of the slice must be one.
|
|
// Required.
|
|
repeated string operations = 1;
|
|
|
|
// Rule is embedded, it describes other criteria of the rule, like
|
|
// APIGroups, APIVersions, Resources, etc.
|
|
optional Rule rule = 2;
|
|
}
|
|
|
|
// ServiceReference holds a reference to Service.legacy.k8s.io
|
|
message ServiceReference {
|
|
// `namespace` is the namespace of the service.
|
|
// Required
|
|
optional string namespace = 1;
|
|
|
|
// `name` is the name of the service.
|
|
// Required
|
|
optional string name = 2;
|
|
|
|
// `path` is an optional URL path which will be sent in any request to
|
|
// this service.
|
|
// +optional
|
|
optional string path = 3;
|
|
}
|
|
|
|
// ValidatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and object without changing it.
|
|
message ValidatingWebhookConfiguration {
|
|
// Standard object metadata; More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata.
|
|
// +optional
|
|
optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
|
|
|
|
// Webhooks is a list of webhooks and the affected resources and operations.
|
|
// +optional
|
|
// +patchMergeKey=name
|
|
// +patchStrategy=merge
|
|
repeated Webhook Webhooks = 2;
|
|
}
|
|
|
|
// ValidatingWebhookConfigurationList is a list of ValidatingWebhookConfiguration.
|
|
message ValidatingWebhookConfigurationList {
|
|
// Standard list metadata.
|
|
// More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds
|
|
// +optional
|
|
optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1;
|
|
|
|
// List of ValidatingWebhookConfiguration.
|
|
repeated ValidatingWebhookConfiguration items = 2;
|
|
}
|
|
|
|
// Webhook describes an admission webhook and the resources and operations it applies to.
|
|
message Webhook {
|
|
// The name of the admission webhook.
|
|
// Name should be fully qualified, e.g., imagepolicy.kubernetes.io, where
|
|
// "imagepolicy" is the name of the webhook, and kubernetes.io is the name
|
|
// of the organization.
|
|
// Required.
|
|
optional string name = 1;
|
|
|
|
// ClientConfig defines how to communicate with the hook.
|
|
// Required
|
|
optional WebhookClientConfig clientConfig = 2;
|
|
|
|
// Rules describes what operations on what resources/subresources the webhook cares about.
|
|
// The webhook cares about an operation if it matches _any_ Rule.
|
|
repeated RuleWithOperations rules = 3;
|
|
|
|
// FailurePolicy defines how unrecognized errors from the admission endpoint are handled -
|
|
// allowed values are Ignore or Fail. Defaults to Ignore.
|
|
// +optional
|
|
optional string failurePolicy = 4;
|
|
|
|
// NamespaceSelector decides whether to run the webhook on an object based
|
|
// on whether the namespace for that object matches the selector. If the
|
|
// object itself is a namespace, the matching is performed on
|
|
// object.metadata.labels. If the object is other cluster scoped resource,
|
|
// it is not subjected to the webhook.
|
|
//
|
|
// For example, to run the webhook on any objects whose namespace is not
|
|
// associated with "runlevel" of "0" or "1"; you will set the selector as
|
|
// follows:
|
|
// "namespaceSelector": {
|
|
// "matchExpressions": [
|
|
// {
|
|
// "key": "runlevel",
|
|
// "operator": "NotIn",
|
|
// "values": [
|
|
// "0",
|
|
// "1"
|
|
// ]
|
|
// }
|
|
// ]
|
|
// }
|
|
//
|
|
// If instead you want to only run the webhook on any objects whose
|
|
// namespace is associated with the "environment" of "prod" or "staging";
|
|
// you will set the selector as follows:
|
|
// "namespaceSelector": {
|
|
// "matchExpressions": [
|
|
// {
|
|
// "key": "environment",
|
|
// "operator": "In",
|
|
// "values": [
|
|
// "prod",
|
|
// "staging"
|
|
// ]
|
|
// }
|
|
// ]
|
|
// }
|
|
//
|
|
// See
|
|
// https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
|
|
// for more examples of label selectors.
|
|
//
|
|
// Default to the empty LabelSelector, which matches everything.
|
|
// +optional
|
|
optional k8s.io.apimachinery.pkg.apis.meta.v1.LabelSelector namespaceSelector = 5;
|
|
}
|
|
|
|
// WebhookClientConfig contains the information to make a TLS
|
|
// connection with the webhook
|
|
message WebhookClientConfig {
|
|
// `url` gives the location of the webhook, in standard URL form
|
|
// (`[scheme://]host:port/path`). Exactly one of `url` or `service`
|
|
// must be specified.
|
|
//
|
|
// The `host` should not refer to a service running in the cluster; use
|
|
// the `service` field instead. The host might be resolved via external
|
|
// DNS in some apiservers (e.g., `kube-apiserver` cannot resolve
|
|
// in-cluster DNS as that would be a layering violation). `host` may
|
|
// also be an IP address.
|
|
//
|
|
// Please note that using `localhost` or `127.0.0.1` as a `host` is
|
|
// risky unless you take great care to run this webhook on all hosts
|
|
// which run an apiserver which might need to make calls to this
|
|
// webhook. Such installs are likely to be non-portable, i.e., not easy
|
|
// to turn up in a new cluster.
|
|
//
|
|
// The scheme must be "https"; the URL must begin with "https://".
|
|
//
|
|
// A path is optional, and if present may be any string permissible in
|
|
// a URL. You may use the path to pass an arbitrary string to the
|
|
// webhook, for example, a cluster identifier.
|
|
//
|
|
// Attempting to use a user or basic auth e.g. "user:password@" is not
|
|
// allowed. Fragments ("#...") and query parameters ("?...") are not
|
|
// allowed, either.
|
|
//
|
|
// +optional
|
|
optional string url = 3;
|
|
|
|
// `service` is a reference to the service for this webhook. Either
|
|
// `service` or `url` must be specified.
|
|
//
|
|
// If the webhook is running within the cluster, then you should use `service`.
|
|
//
|
|
// If there is only one port open for the service, that port will be
|
|
// used. If there are multiple ports open, port 443 will be used if it
|
|
// is open, otherwise it is an error.
|
|
//
|
|
// +optional
|
|
optional ServiceReference service = 1;
|
|
|
|
// `caBundle` is a PEM encoded CA bundle which will be used to validate
|
|
// the webhook's server certificate.
|
|
// Required.
|
|
optional bytes caBundle = 2;
|
|
}
|
|
|