12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031 |
- /*
- Copyright 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.extensions.v1beta1;
- import "k8s.io/api/core/v1/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 = "k8s.io/api/extensions/v1beta1";
- // DEPRECATED - This group version of DaemonSet is deprecated by apps/v1beta2/DaemonSet. See the release notes for
- // more information.
- // DaemonSet represents the configuration of a daemon set.
- message DaemonSet {
- // Standard object's metadata.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
- // The desired behavior of this daemon set.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- // +optional
- optional DaemonSetSpec spec = 2;
- // The current status of this daemon set. This data may be
- // out of date by some window of time.
- // Populated by the system.
- // Read-only.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- // +optional
- optional DaemonSetStatus status = 3;
- }
- // DaemonSetCondition describes the state of a DaemonSet at a certain point.
- message DaemonSetCondition {
- // Type of DaemonSet condition.
- optional string type = 1;
- // Status of the condition, one of True, False, Unknown.
- optional string status = 2;
- // Last time the condition transitioned from one status to another.
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.Time lastTransitionTime = 3;
- // The reason for the condition's last transition.
- // +optional
- optional string reason = 4;
- // A human readable message indicating details about the transition.
- // +optional
- optional string message = 5;
- }
- // DaemonSetList is a collection of daemon sets.
- message DaemonSetList {
- // Standard list metadata.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1;
- // A list of daemon sets.
- repeated DaemonSet items = 2;
- }
- // DaemonSetSpec is the specification of a daemon set.
- message DaemonSetSpec {
- // A label query over pods that are managed by the daemon set.
- // Must match in order to be controlled.
- // If empty, defaulted to labels on Pod template.
- // More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.LabelSelector selector = 1;
- // An object that describes the pod that will be created.
- // The DaemonSet will create exactly one copy of this pod on every node
- // that matches the template's node selector (or on every node if no node
- // selector is specified).
- // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#pod-template
- optional k8s.io.api.core.v1.PodTemplateSpec template = 2;
- // An update strategy to replace existing DaemonSet pods with new pods.
- // +optional
- optional DaemonSetUpdateStrategy updateStrategy = 3;
- // The minimum number of seconds for which a newly created DaemonSet pod should
- // be ready without any of its container crashing, for it to be considered
- // available. Defaults to 0 (pod will be considered available as soon as it
- // is ready).
- // +optional
- optional int32 minReadySeconds = 4;
- // DEPRECATED.
- // A sequence number representing a specific generation of the template.
- // Populated by the system. It can be set only during the creation.
- // +optional
- optional int64 templateGeneration = 5;
- // The number of old history to retain to allow rollback.
- // This is a pointer to distinguish between explicit zero and not specified.
- // Defaults to 10.
- // +optional
- optional int32 revisionHistoryLimit = 6;
- }
- // DaemonSetStatus represents the current status of a daemon set.
- message DaemonSetStatus {
- // The number of nodes that are running at least 1
- // daemon pod and are supposed to run the daemon pod.
- // More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
- optional int32 currentNumberScheduled = 1;
- // The number of nodes that are running the daemon pod, but are
- // not supposed to run the daemon pod.
- // More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
- optional int32 numberMisscheduled = 2;
- // The total number of nodes that should be running the daemon
- // pod (including nodes correctly running the daemon pod).
- // More info: https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/
- optional int32 desiredNumberScheduled = 3;
- // The number of nodes that should be running the daemon pod and have one
- // or more of the daemon pod running and ready.
- optional int32 numberReady = 4;
- // The most recent generation observed by the daemon set controller.
- // +optional
- optional int64 observedGeneration = 5;
- // The total number of nodes that are running updated daemon pod
- // +optional
- optional int32 updatedNumberScheduled = 6;
- // The number of nodes that should be running the
- // daemon pod and have one or more of the daemon pod running and
- // available (ready for at least spec.minReadySeconds)
- // +optional
- optional int32 numberAvailable = 7;
- // The number of nodes that should be running the
- // daemon pod and have none of the daemon pod running and available
- // (ready for at least spec.minReadySeconds)
- // +optional
- optional int32 numberUnavailable = 8;
- // Count of hash collisions for the DaemonSet. The DaemonSet controller
- // uses this field as a collision avoidance mechanism when it needs to
- // create the name for the newest ControllerRevision.
- // +optional
- optional int32 collisionCount = 9;
- // Represents the latest available observations of a DaemonSet's current state.
- // +optional
- // +patchMergeKey=type
- // +patchStrategy=merge
- repeated DaemonSetCondition conditions = 10;
- }
- // DaemonSetUpdateStrategy indicates the strategy that the DaemonSet
- // controller will use to perform updates. It includes any additional parameters
- // necessary to perform the update for the indicated strategy.
- message DaemonSetUpdateStrategy {
- // Type of daemon set update. Can be "RollingUpdate" or "OnDelete".
- // Default is OnDelete.
- // +optional
- optional string type = 1;
- // Rolling update config params. Present only if type = "RollingUpdate".
- // ---
- // TODO: Update this to follow our convention for oneOf, whatever we decide it
- // to be. Same as Deployment `strategy.rollingUpdate`.
- // See https://github.com/kubernetes/kubernetes/issues/35345
- // +optional
- optional RollingUpdateDaemonSet rollingUpdate = 2;
- }
- // DEPRECATED - This group version of Deployment is deprecated by apps/v1beta2/Deployment. See the release notes for
- // more information.
- // Deployment enables declarative updates for Pods and ReplicaSets.
- message Deployment {
- // Standard object metadata.
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
- // Specification of the desired behavior of the Deployment.
- // +optional
- optional DeploymentSpec spec = 2;
- // Most recently observed status of the Deployment.
- // +optional
- optional DeploymentStatus status = 3;
- }
- // DeploymentCondition describes the state of a deployment at a certain point.
- message DeploymentCondition {
- // Type of deployment condition.
- optional string type = 1;
- // Status of the condition, one of True, False, Unknown.
- optional string status = 2;
- // The last time this condition was updated.
- optional k8s.io.apimachinery.pkg.apis.meta.v1.Time lastUpdateTime = 6;
- // Last time the condition transitioned from one status to another.
- optional k8s.io.apimachinery.pkg.apis.meta.v1.Time lastTransitionTime = 7;
- // The reason for the condition's last transition.
- optional string reason = 4;
- // A human readable message indicating details about the transition.
- optional string message = 5;
- }
- // DeploymentList is a list of Deployments.
- message DeploymentList {
- // Standard list metadata.
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1;
- // Items is the list of Deployments.
- repeated Deployment items = 2;
- }
- // DEPRECATED.
- // DeploymentRollback stores the information required to rollback a deployment.
- message DeploymentRollback {
- // Required: This must match the Name of a deployment.
- optional string name = 1;
- // The annotations to be updated to a deployment
- // +optional
- map<string, string> updatedAnnotations = 2;
- // The config of this deployment rollback.
- optional RollbackConfig rollbackTo = 3;
- }
- // DeploymentSpec is the specification of the desired behavior of the Deployment.
- message DeploymentSpec {
- // Number of desired pods. This is a pointer to distinguish between explicit
- // zero and not specified. Defaults to 1.
- // +optional
- optional int32 replicas = 1;
- // Label selector for pods. Existing ReplicaSets whose pods are
- // selected by this will be the ones affected by this deployment.
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.LabelSelector selector = 2;
- // Template describes the pods that will be created.
- optional k8s.io.api.core.v1.PodTemplateSpec template = 3;
- // The deployment strategy to use to replace existing pods with new ones.
- // +optional
- // +patchStrategy=retainKeys
- optional DeploymentStrategy strategy = 4;
- // Minimum number of seconds for which a newly created pod should be ready
- // without any of its container crashing, for it to be considered available.
- // Defaults to 0 (pod will be considered available as soon as it is ready)
- // +optional
- optional int32 minReadySeconds = 5;
- // The number of old ReplicaSets to retain to allow rollback.
- // This is a pointer to distinguish between explicit zero and not specified.
- // This is set to the max value of int32 (i.e. 2147483647) by default, which
- // means "retaining all old ReplicaSets".
- // +optional
- optional int32 revisionHistoryLimit = 6;
- // Indicates that the deployment is paused and will not be processed by the
- // deployment controller.
- // +optional
- optional bool paused = 7;
- // DEPRECATED.
- // The config this deployment is rolling back to. Will be cleared after rollback is done.
- // +optional
- optional RollbackConfig rollbackTo = 8;
- // The maximum time in seconds for a deployment to make progress before it
- // is considered to be failed. The deployment controller will continue to
- // process failed deployments and a condition with a ProgressDeadlineExceeded
- // reason will be surfaced in the deployment status. Note that progress will
- // not be estimated during the time a deployment is paused. This is set to
- // the max value of int32 (i.e. 2147483647) by default, which means "no deadline".
- // +optional
- optional int32 progressDeadlineSeconds = 9;
- }
- // DeploymentStatus is the most recently observed status of the Deployment.
- message DeploymentStatus {
- // The generation observed by the deployment controller.
- // +optional
- optional int64 observedGeneration = 1;
- // Total number of non-terminated pods targeted by this deployment (their labels match the selector).
- // +optional
- optional int32 replicas = 2;
- // Total number of non-terminated pods targeted by this deployment that have the desired template spec.
- // +optional
- optional int32 updatedReplicas = 3;
- // Total number of ready pods targeted by this deployment.
- // +optional
- optional int32 readyReplicas = 7;
- // Total number of available pods (ready for at least minReadySeconds) targeted by this deployment.
- // +optional
- optional int32 availableReplicas = 4;
- // Total number of unavailable pods targeted by this deployment. This is the total number of
- // pods that are still required for the deployment to have 100% available capacity. They may
- // either be pods that are running but not yet available or pods that still have not been created.
- // +optional
- optional int32 unavailableReplicas = 5;
- // Represents the latest available observations of a deployment's current state.
- // +patchMergeKey=type
- // +patchStrategy=merge
- repeated DeploymentCondition conditions = 6;
- // Count of hash collisions for the Deployment. The Deployment controller uses this
- // field as a collision avoidance mechanism when it needs to create the name for the
- // newest ReplicaSet.
- // +optional
- optional int32 collisionCount = 8;
- }
- // DeploymentStrategy describes how to replace existing pods with new ones.
- message DeploymentStrategy {
- // Type of deployment. Can be "Recreate" or "RollingUpdate". Default is RollingUpdate.
- // +optional
- optional string type = 1;
- // Rolling update config params. Present only if DeploymentStrategyType =
- // RollingUpdate.
- // ---
- // TODO: Update this to follow our convention for oneOf, whatever we decide it
- // to be.
- // +optional
- optional RollingUpdateDeployment rollingUpdate = 2;
- }
- // HTTPIngressPath associates a path with a backend. Incoming urls matching the
- // path are forwarded to the backend.
- message HTTPIngressPath {
- // Path is matched against the path of an incoming request. Currently it can
- // contain characters disallowed from the conventional "path" part of a URL
- // as defined by RFC 3986. Paths must begin with a '/'. When unspecified,
- // all paths from incoming requests are matched.
- // +optional
- optional string path = 1;
- // PathType determines the interpretation of the Path matching. PathType can
- // be one of the following values:
- // * Exact: Matches the URL path exactly.
- // * Prefix: Matches based on a URL path prefix split by '/'. Matching is
- // done on a path element by element basis. A path element refers is the
- // list of labels in the path split by the '/' separator. A request is a
- // match for path p if every p is an element-wise prefix of p of the
- // request path. Note that if the last element of the path is a substring
- // of the last element in request path, it is not a match (e.g. /foo/bar
- // matches /foo/bar/baz, but does not match /foo/barbaz).
- // * ImplementationSpecific: Interpretation of the Path matching is up to
- // the IngressClass. Implementations can treat this as a separate PathType
- // or treat it identically to Prefix or Exact path types.
- // Implementations are required to support all path types.
- // Defaults to ImplementationSpecific.
- optional string pathType = 3;
- // Backend defines the referenced service endpoint to which the traffic
- // will be forwarded to.
- optional IngressBackend backend = 2;
- }
- // HTTPIngressRuleValue is a list of http selectors pointing to backends.
- // In the example: http://<host>/<path>?<searchpart> -> backend where
- // where parts of the url correspond to RFC 3986, this resource will be used
- // to match against everything after the last '/' and before the first '?'
- // or '#'.
- message HTTPIngressRuleValue {
- // A collection of paths that map requests to backends.
- repeated HTTPIngressPath paths = 1;
- }
- // DEPRECATED 1.9 - This group version of IPBlock is deprecated by networking/v1/IPBlock.
- // IPBlock describes a particular CIDR (Ex. "192.168.1.0/24","2001:db8::/64") that is allowed
- // to the pods matched by a NetworkPolicySpec's podSelector. The except entry describes CIDRs
- // that should not be included within this rule.
- message IPBlock {
- // CIDR is a string representing the IP Block
- // Valid examples are "192.168.1.0/24" or "2001:db8::/64"
- optional string cidr = 1;
- // Except is a slice of CIDRs that should not be included within an IP Block
- // Valid examples are "192.168.1.0/24" or "2001:db8::/64"
- // Except values will be rejected if they are outside the CIDR range
- // +optional
- repeated string except = 2;
- }
- // Ingress is a collection of rules that allow inbound connections to reach the
- // endpoints defined by a backend. An Ingress can be configured to give services
- // externally-reachable urls, load balance traffic, terminate SSL, offer name
- // based virtual hosting etc.
- // DEPRECATED - This group version of Ingress is deprecated by networking.k8s.io/v1beta1 Ingress. See the release notes for more information.
- message Ingress {
- // Standard object's metadata.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
- // Spec is the desired state of the Ingress.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- // +optional
- optional IngressSpec spec = 2;
- // Status is the current state of the Ingress.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- // +optional
- optional IngressStatus status = 3;
- }
- // IngressBackend describes all endpoints for a given service and port.
- message IngressBackend {
- // Specifies the name of the referenced service.
- // +optional
- optional string serviceName = 1;
- // Specifies the port of the referenced service.
- // +optional
- optional k8s.io.apimachinery.pkg.util.intstr.IntOrString servicePort = 2;
- // Resource is an ObjectRef to another Kubernetes resource in the namespace
- // of the Ingress object. If resource is specified, serviceName and servicePort
- // must not be specified.
- // +optional
- optional k8s.io.api.core.v1.TypedLocalObjectReference resource = 3;
- }
- // IngressList is a collection of Ingress.
- message IngressList {
- // Standard object's metadata.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1;
- // Items is the list of Ingress.
- repeated Ingress items = 2;
- }
- // IngressLoadBalancerIngress represents the status of a load-balancer ingress point.
- message IngressLoadBalancerIngress {
- // IP is set for load-balancer ingress points that are IP based.
- // +optional
- optional string ip = 1;
- // Hostname is set for load-balancer ingress points that are DNS based.
- // +optional
- optional string hostname = 2;
- // Ports provides information about the ports exposed by this LoadBalancer.
- // +listType=atomic
- // +optional
- repeated IngressPortStatus ports = 4;
- }
- // LoadBalancerStatus represents the status of a load-balancer.
- message IngressLoadBalancerStatus {
- // Ingress is a list containing ingress points for the load-balancer.
- // +optional
- repeated IngressLoadBalancerIngress ingress = 1;
- }
- // IngressPortStatus represents the error condition of a service port
- message IngressPortStatus {
- // Port is the port number of the ingress port.
- optional int32 port = 1;
- // Protocol is the protocol of the ingress port.
- // The supported values are: "TCP", "UDP", "SCTP"
- optional string protocol = 2;
- // Error is to record the problem with the service port
- // The format of the error shall comply with the following rules:
- // - built-in error values shall be specified in this file and those shall use
- // CamelCase names
- // - cloud provider specific error values must have names that comply with the
- // format foo.example.com/CamelCase.
- // ---
- // The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
- // +optional
- // +kubebuilder:validation:Required
- // +kubebuilder:validation:Pattern=`^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$`
- // +kubebuilder:validation:MaxLength=316
- optional string error = 3;
- }
- // IngressRule represents the rules mapping the paths under a specified host to
- // the related backend services. Incoming requests are first evaluated for a host
- // match, then routed to the backend associated with the matching IngressRuleValue.
- message IngressRule {
- // Host is the fully qualified domain name of a network host, as defined by RFC 3986.
- // Note the following deviations from the "host" part of the
- // URI as defined in RFC 3986:
- // 1. IPs are not allowed. Currently an IngressRuleValue can only apply to
- // the IP in the Spec of the parent Ingress.
- // 2. The `:` delimiter is not respected because ports are not allowed.
- // Currently the port of an Ingress is implicitly :80 for http and
- // :443 for https.
- // Both these may change in the future.
- // Incoming requests are matched against the host before the
- // IngressRuleValue. If the host is unspecified, the Ingress routes all
- // traffic based on the specified IngressRuleValue.
- //
- // Host can be "precise" which is a domain name without the terminating dot of
- // a network host (e.g. "foo.bar.com") or "wildcard", which is a domain name
- // prefixed with a single wildcard label (e.g. "*.foo.com").
- // The wildcard character '*' must appear by itself as the first DNS label and
- // matches only a single label. You cannot have a wildcard label by itself (e.g. Host == "*").
- // Requests will be matched against the Host field in the following way:
- // 1. If Host is precise, the request matches this rule if the http host header is equal to Host.
- // 2. If Host is a wildcard, then the request matches this rule if the http host header
- // is to equal to the suffix (removing the first label) of the wildcard rule.
- // +optional
- optional string host = 1;
- // IngressRuleValue represents a rule to route requests for this IngressRule.
- // If unspecified, the rule defaults to a http catch-all. Whether that sends
- // just traffic matching the host to the default backend or all traffic to the
- // default backend, is left to the controller fulfilling the Ingress. Http is
- // currently the only supported IngressRuleValue.
- // +optional
- optional IngressRuleValue ingressRuleValue = 2;
- }
- // IngressRuleValue represents a rule to apply against incoming requests. If the
- // rule is satisfied, the request is routed to the specified backend. Currently
- // mixing different types of rules in a single Ingress is disallowed, so exactly
- // one of the following must be set.
- message IngressRuleValue {
- // http is a list of http selectors pointing to backends.
- // A path is matched against the path of an incoming request. Currently it can
- // contain characters disallowed from the conventional "path" part of a URL
- // as defined by RFC 3986. Paths must begin with a '/'.
- // A backend defines the referenced service endpoint to which the traffic
- // will be forwarded to.
- optional HTTPIngressRuleValue http = 1;
- }
- // IngressSpec describes the Ingress the user wishes to exist.
- message IngressSpec {
- // IngressClassName is the name of the IngressClass cluster resource. The
- // associated IngressClass defines which controller will implement the
- // resource. This replaces the deprecated `kubernetes.io/ingress.class`
- // annotation. For backwards compatibility, when that annotation is set, it
- // must be given precedence over this field. The controller may emit a
- // warning if the field and annotation have different values.
- // Implementations of this API should ignore Ingresses without a class
- // specified. An IngressClass resource may be marked as default, which can
- // be used to set a default value for this field. For more information,
- // refer to the IngressClass documentation.
- // +optional
- optional string ingressClassName = 4;
- // A default backend capable of servicing requests that don't match any
- // rule. At least one of 'backend' or 'rules' must be specified. This field
- // is optional to allow the loadbalancer controller or defaulting logic to
- // specify a global default.
- // +optional
- optional IngressBackend backend = 1;
- // TLS configuration. Currently the Ingress only supports a single TLS
- // port, 443. If multiple members of this list specify different hosts, they
- // will be multiplexed on the same port according to the hostname specified
- // through the SNI TLS extension, if the ingress controller fulfilling the
- // ingress supports SNI.
- // +optional
- repeated IngressTLS tls = 2;
- // A list of host rules used to configure the Ingress. If unspecified, or
- // no rule matches, all traffic is sent to the default backend.
- // +optional
- repeated IngressRule rules = 3;
- }
- // IngressStatus describe the current state of the Ingress.
- message IngressStatus {
- // LoadBalancer contains the current status of the load-balancer.
- // +optional
- optional IngressLoadBalancerStatus loadBalancer = 1;
- }
- // IngressTLS describes the transport layer security associated with an Ingress.
- message IngressTLS {
- // Hosts are a list of hosts included in the TLS certificate. The values in
- // this list must match the name/s used in the tlsSecret. Defaults to the
- // wildcard host setting for the loadbalancer controller fulfilling this
- // Ingress, if left unspecified.
- // +optional
- repeated string hosts = 1;
- // SecretName is the name of the secret used to terminate SSL traffic on 443.
- // Field is left optional to allow SSL routing based on SNI hostname alone.
- // If the SNI host in a listener conflicts with the "Host" header field used
- // by an IngressRule, the SNI host is used for termination and value of the
- // Host header is used for routing.
- // +optional
- optional string secretName = 2;
- }
- // DEPRECATED 1.9 - This group version of NetworkPolicy is deprecated by networking/v1/NetworkPolicy.
- // NetworkPolicy describes what network traffic is allowed for a set of Pods
- message NetworkPolicy {
- // Standard object's metadata.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
- // Specification of the desired behavior for this NetworkPolicy.
- // +optional
- optional NetworkPolicySpec spec = 2;
- }
- // DEPRECATED 1.9 - This group version of NetworkPolicyEgressRule is deprecated by networking/v1/NetworkPolicyEgressRule.
- // NetworkPolicyEgressRule describes a particular set of traffic that is allowed out of pods
- // matched by a NetworkPolicySpec's podSelector. The traffic must match both ports and to.
- // This type is beta-level in 1.8
- message NetworkPolicyEgressRule {
- // List of destination ports for outgoing traffic.
- // Each item in this list is combined using a logical OR. If this field is
- // empty or missing, this rule matches all ports (traffic not restricted by port).
- // If this field is present and contains at least one item, then this rule allows
- // traffic only if the traffic matches at least one port in the list.
- // +optional
- repeated NetworkPolicyPort ports = 1;
- // List of destinations for outgoing traffic of pods selected for this rule.
- // Items in this list are combined using a logical OR operation. If this field is
- // empty or missing, this rule matches all destinations (traffic not restricted by
- // destination). If this field is present and contains at least one item, this rule
- // allows traffic only if the traffic matches at least one item in the to list.
- // +optional
- repeated NetworkPolicyPeer to = 2;
- }
- // DEPRECATED 1.9 - This group version of NetworkPolicyIngressRule is deprecated by networking/v1/NetworkPolicyIngressRule.
- // This NetworkPolicyIngressRule matches traffic if and only if the traffic matches both ports AND from.
- message NetworkPolicyIngressRule {
- // List of ports which should be made accessible on the pods selected for this rule.
- // Each item in this list is combined using a logical OR.
- // If this field is empty or missing, this rule matches all ports (traffic not restricted by port).
- // If this field is present and contains at least one item, then this rule allows traffic
- // only if the traffic matches at least one port in the list.
- // +optional
- repeated NetworkPolicyPort ports = 1;
- // List of sources which should be able to access the pods selected for this rule.
- // Items in this list are combined using a logical OR operation.
- // If this field is empty or missing, this rule matches all sources (traffic not restricted by source).
- // If this field is present and contains at least one item, this rule allows traffic only if the
- // traffic matches at least one item in the from list.
- // +optional
- repeated NetworkPolicyPeer from = 2;
- }
- // DEPRECATED 1.9 - This group version of NetworkPolicyList is deprecated by networking/v1/NetworkPolicyList.
- // Network Policy List is a list of NetworkPolicy objects.
- message NetworkPolicyList {
- // Standard list metadata.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1;
- // Items is a list of schema objects.
- repeated NetworkPolicy items = 2;
- }
- // DEPRECATED 1.9 - This group version of NetworkPolicyPeer is deprecated by networking/v1/NetworkPolicyPeer.
- message NetworkPolicyPeer {
- // This is a label selector which selects Pods. This field follows standard label
- // selector semantics; if present but empty, it selects all pods.
- //
- // If NamespaceSelector is also set, then the NetworkPolicyPeer as a whole selects
- // the Pods matching PodSelector in the Namespaces selected by NamespaceSelector.
- // Otherwise it selects the Pods matching PodSelector in the policy's own Namespace.
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.LabelSelector podSelector = 1;
- // Selects Namespaces using cluster-scoped labels. This field follows standard label
- // selector semantics; if present but empty, it selects all namespaces.
- //
- // If PodSelector is also set, then the NetworkPolicyPeer as a whole selects
- // the Pods matching PodSelector in the Namespaces selected by NamespaceSelector.
- // Otherwise it selects all Pods in the Namespaces selected by NamespaceSelector.
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.LabelSelector namespaceSelector = 2;
- // IPBlock defines policy on a particular IPBlock. If this field is set then
- // neither of the other fields can be.
- // +optional
- optional IPBlock ipBlock = 3;
- }
- // DEPRECATED 1.9 - This group version of NetworkPolicyPort is deprecated by networking/v1/NetworkPolicyPort.
- message NetworkPolicyPort {
- // Optional. The protocol (TCP, UDP, or SCTP) which traffic must match.
- // If not specified, this field defaults to TCP.
- // +optional
- optional string protocol = 1;
- // The port on the given protocol. This can either be a numerical or named
- // port on a pod. If this field is not provided, this matches all port names and
- // numbers.
- // If present, only traffic on the specified protocol AND port will be matched.
- // +optional
- optional k8s.io.apimachinery.pkg.util.intstr.IntOrString port = 2;
- // If set, indicates that the range of ports from port to endPort, inclusive,
- // should be allowed by the policy. This field cannot be defined if the port field
- // is not defined or if the port field is defined as a named (string) port.
- // The endPort must be equal or greater than port.
- // +optional
- optional int32 endPort = 3;
- }
- // DEPRECATED 1.9 - This group version of NetworkPolicySpec is deprecated by networking/v1/NetworkPolicySpec.
- message NetworkPolicySpec {
- // Selects the pods to which this NetworkPolicy object applies. The array of ingress rules
- // is applied to any pods selected by this field. Multiple network policies can select the
- // same set of pods. In this case, the ingress rules for each are combined additively.
- // This field is NOT optional and follows standard label selector semantics.
- // An empty podSelector matches all pods in this namespace.
- optional k8s.io.apimachinery.pkg.apis.meta.v1.LabelSelector podSelector = 1;
- // List of ingress rules to be applied to the selected pods.
- // Traffic is allowed to a pod if there are no NetworkPolicies selecting the pod
- // OR if the traffic source is the pod's local node,
- // OR if the traffic matches at least one ingress rule across all of the NetworkPolicy
- // objects whose podSelector matches the pod.
- // If this field is empty then this NetworkPolicy does not allow any traffic
- // (and serves solely to ensure that the pods it selects are isolated by default).
- // +optional
- repeated NetworkPolicyIngressRule ingress = 2;
- // List of egress rules to be applied to the selected pods. Outgoing traffic is
- // allowed if there are no NetworkPolicies selecting the pod (and cluster policy
- // otherwise allows the traffic), OR if the traffic matches at least one egress rule
- // across all of the NetworkPolicy objects whose podSelector matches the pod. If
- // this field is empty then this NetworkPolicy limits all outgoing traffic (and serves
- // solely to ensure that the pods it selects are isolated by default).
- // This field is beta-level in 1.8
- // +optional
- repeated NetworkPolicyEgressRule egress = 3;
- // List of rule types that the NetworkPolicy relates to.
- // Valid options are ["Ingress"], ["Egress"], or ["Ingress", "Egress"].
- // If this field is not specified, it will default based on the existence of Ingress or Egress rules;
- // policies that contain an Egress section are assumed to affect Egress, and all policies
- // (whether or not they contain an Ingress section) are assumed to affect Ingress.
- // If you want to write an egress-only policy, you must explicitly specify policyTypes [ "Egress" ].
- // Likewise, if you want to write a policy that specifies that no egress is allowed,
- // you must specify a policyTypes value that include "Egress" (since such a policy would not include
- // an Egress section and would otherwise default to just [ "Ingress" ]).
- // This field is beta-level in 1.8
- // +optional
- repeated string policyTypes = 4;
- }
- // DEPRECATED - This group version of ReplicaSet is deprecated by apps/v1beta2/ReplicaSet. See the release notes for
- // more information.
- // ReplicaSet ensures that a specified number of pod replicas are running at any given time.
- message ReplicaSet {
- // If the Labels of a ReplicaSet are empty, they are defaulted to
- // be the same as the Pod(s) that the ReplicaSet manages.
- // Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
- // Spec defines the specification of the desired behavior of the ReplicaSet.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- // +optional
- optional ReplicaSetSpec spec = 2;
- // Status is the most recently observed status of the ReplicaSet.
- // This data may be out of date by some window of time.
- // Populated by the system.
- // Read-only.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- // +optional
- optional ReplicaSetStatus status = 3;
- }
- // ReplicaSetCondition describes the state of a replica set at a certain point.
- message ReplicaSetCondition {
- // Type of replica set condition.
- optional string type = 1;
- // Status of the condition, one of True, False, Unknown.
- optional string status = 2;
- // The last time the condition transitioned from one status to another.
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.Time lastTransitionTime = 3;
- // The reason for the condition's last transition.
- // +optional
- optional string reason = 4;
- // A human readable message indicating details about the transition.
- // +optional
- optional string message = 5;
- }
- // ReplicaSetList is a collection of ReplicaSets.
- message ReplicaSetList {
- // Standard list metadata.
- // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1;
- // List of ReplicaSets.
- // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller
- repeated ReplicaSet items = 2;
- }
- // ReplicaSetSpec is the specification of a ReplicaSet.
- message ReplicaSetSpec {
- // Replicas is the number of desired replicas.
- // This is a pointer to distinguish between explicit zero and unspecified.
- // Defaults to 1.
- // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
- // +optional
- optional int32 replicas = 1;
- // Minimum number of seconds for which a newly created pod should be ready
- // without any of its container crashing, for it to be considered available.
- // Defaults to 0 (pod will be considered available as soon as it is ready)
- // +optional
- optional int32 minReadySeconds = 4;
- // Selector is a label query over pods that should match the replica count.
- // If the selector is empty, it is defaulted to the labels present on the pod template.
- // Label keys and values that must match in order to be controlled by this replica set.
- // More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.LabelSelector selector = 2;
- // Template is the object that describes the pod that will be created if
- // insufficient replicas are detected.
- // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#pod-template
- // +optional
- optional k8s.io.api.core.v1.PodTemplateSpec template = 3;
- }
- // ReplicaSetStatus represents the current status of a ReplicaSet.
- message ReplicaSetStatus {
- // Replicas is the most recently observed number of replicas.
- // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
- optional int32 replicas = 1;
- // The number of pods that have labels matching the labels of the pod template of the replicaset.
- // +optional
- optional int32 fullyLabeledReplicas = 2;
- // The number of ready replicas for this replica set.
- // +optional
- optional int32 readyReplicas = 4;
- // The number of available replicas (ready for at least minReadySeconds) for this replica set.
- // +optional
- optional int32 availableReplicas = 5;
- // ObservedGeneration reflects the generation of the most recently observed ReplicaSet.
- // +optional
- optional int64 observedGeneration = 3;
- // Represents the latest available observations of a replica set's current state.
- // +optional
- // +patchMergeKey=type
- // +patchStrategy=merge
- repeated ReplicaSetCondition conditions = 6;
- }
- // DEPRECATED.
- message RollbackConfig {
- // The revision to rollback to. If set to 0, rollback to the last revision.
- // +optional
- optional int64 revision = 1;
- }
- // Spec to control the desired behavior of daemon set rolling update.
- message RollingUpdateDaemonSet {
- // The maximum number of DaemonSet pods that can be unavailable during the
- // update. Value can be an absolute number (ex: 5) or a percentage of total
- // number of DaemonSet pods at the start of the update (ex: 10%). Absolute
- // number is calculated from percentage by rounding up.
- // This cannot be 0 if MaxSurge is 0
- // Default value is 1.
- // Example: when this is set to 30%, at most 30% of the total number of nodes
- // that should be running the daemon pod (i.e. status.desiredNumberScheduled)
- // can have their pods stopped for an update at any given time. The update
- // starts by stopping at most 30% of those DaemonSet pods and then brings
- // up new DaemonSet pods in their place. Once the new pods are available,
- // it then proceeds onto other DaemonSet pods, thus ensuring that at least
- // 70% of original number of DaemonSet pods are available at all times during
- // the update.
- // +optional
- optional k8s.io.apimachinery.pkg.util.intstr.IntOrString maxUnavailable = 1;
- // The maximum number of nodes with an existing available DaemonSet pod that
- // can have an updated DaemonSet pod during during an update.
- // Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%).
- // This can not be 0 if MaxUnavailable is 0.
- // Absolute number is calculated from percentage by rounding up to a minimum of 1.
- // Default value is 0.
- // Example: when this is set to 30%, at most 30% of the total number of nodes
- // that should be running the daemon pod (i.e. status.desiredNumberScheduled)
- // can have their a new pod created before the old pod is marked as deleted.
- // The update starts by launching new pods on 30% of nodes. Once an updated
- // pod is available (Ready for at least minReadySeconds) the old DaemonSet pod
- // on that node is marked deleted. If the old pod becomes unavailable for any
- // reason (Ready transitions to false, is evicted, or is drained) an updated
- // pod is immediatedly created on that node without considering surge limits.
- // Allowing surge implies the possibility that the resources consumed by the
- // daemonset on any given node can double if the readiness check fails, and
- // so resource intensive daemonsets should take into account that they may
- // cause evictions during disruption.
- // This is an alpha field and requires enabling DaemonSetUpdateSurge feature gate.
- // +optional
- optional k8s.io.apimachinery.pkg.util.intstr.IntOrString maxSurge = 2;
- }
- // Spec to control the desired behavior of rolling update.
- message RollingUpdateDeployment {
- // The maximum number of pods that can be unavailable during the update.
- // Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%).
- // Absolute number is calculated from percentage by rounding down.
- // This can not be 0 if MaxSurge is 0.
- // By default, a fixed value of 1 is used.
- // Example: when this is set to 30%, the old RC can be scaled down to 70% of desired pods
- // immediately when the rolling update starts. Once new pods are ready, old RC
- // can be scaled down further, followed by scaling up the new RC, ensuring
- // that the total number of pods available at all times during the update is at
- // least 70% of desired pods.
- // +optional
- optional k8s.io.apimachinery.pkg.util.intstr.IntOrString maxUnavailable = 1;
- // The maximum number of pods that can be scheduled above the desired number of
- // pods.
- // Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%).
- // This can not be 0 if MaxUnavailable is 0.
- // Absolute number is calculated from percentage by rounding up.
- // By default, a value of 1 is used.
- // Example: when this is set to 30%, the new RC can be scaled up immediately when
- // the rolling update starts, such that the total number of old and new pods do not exceed
- // 130% of desired pods. Once old pods have been killed,
- // new RC can be scaled up further, ensuring that total number of pods running
- // at any time during the update is at most 130% of desired pods.
- // +optional
- optional k8s.io.apimachinery.pkg.util.intstr.IntOrString maxSurge = 2;
- }
- // represents a scaling request for a resource.
- message Scale {
- // Standard object metadata; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata.
- // +optional
- optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
- // defines the behavior of the scale. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status.
- // +optional
- optional ScaleSpec spec = 2;
- // current status of the scale. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status. Read-only.
- // +optional
- optional ScaleStatus status = 3;
- }
- // describes the attributes of a scale subresource
- message ScaleSpec {
- // desired number of instances for the scaled object.
- // +optional
- optional int32 replicas = 1;
- }
- // represents the current status of a scale subresource.
- message ScaleStatus {
- // actual number of observed instances of the scaled object.
- optional int32 replicas = 1;
- // selector is a label query over pods that should match the replicas count. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
- // +optional
- // +mapType=atomic
- map<string, string> selector = 2;
- // label selector for pods that should match the replicas count. This is a serializated
- // version of both map-based and more expressive set-based selectors. This is done to
- // avoid introspection in the clients. The string will be in the same format as the
- // query-param syntax. If the target type only supports map-based selectors, both this
- // field and map-based selector field are populated.
- // More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
- // +optional
- optional string targetSelector = 3;
- }
|