123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041 |
- /*
- Copyright 2016 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.kubernetes.pkg.apis.extensions.v1beta1;
- import "k8s.io/kubernetes/pkg/api/resource/generated.proto";
- import "k8s.io/kubernetes/pkg/api/unversioned/generated.proto";
- import "k8s.io/kubernetes/pkg/api/v1/generated.proto";
- import "k8s.io/kubernetes/pkg/runtime/generated.proto";
- import "k8s.io/kubernetes/pkg/util/intstr/generated.proto";
- // Package-wide variables from generator "generated".
- option go_package = "v1beta1";
- // An APIVersion represents a single concrete version of an object model.
- message APIVersion {
- // Name of this version (e.g. 'v1').
- optional string name = 1;
- }
- message CPUTargetUtilization {
- // fraction of the requested CPU that should be utilized/used,
- // e.g. 70 means that 70% of the requested CPU should be in use.
- optional int32 targetPercentage = 1;
- }
- message CustomMetricCurrentStatus {
- // Custom Metric name.
- optional string name = 1;
- // Custom Metric value (average).
- optional k8s.io.kubernetes.pkg.api.resource.Quantity value = 2;
- }
- message CustomMetricCurrentStatusList {
- repeated CustomMetricCurrentStatus items = 1;
- }
- // Alpha-level support for Custom Metrics in HPA (as annotations).
- message CustomMetricTarget {
- // Custom Metric name.
- optional string name = 1;
- // Custom Metric value (average).
- optional k8s.io.kubernetes.pkg.api.resource.Quantity value = 2;
- }
- message CustomMetricTargetList {
- repeated CustomMetricTarget items = 1;
- }
- // DaemonSet represents the configuration of a daemon set.
- message DaemonSet {
- // Standard object's metadata.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.v1.ObjectMeta metadata = 1;
- // Spec defines the desired behavior of this daemon set.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#spec-and-status
- optional DaemonSetSpec spec = 2;
- // Status is 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: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#spec-and-status
- optional DaemonSetStatus status = 3;
- }
- // DaemonSetList is a collection of daemon sets.
- message DaemonSetList {
- // Standard list metadata.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
- // Items is a list of daemon sets.
- repeated DaemonSet items = 2;
- }
- // DaemonSetSpec is the specification of a daemon set.
- message DaemonSetSpec {
- // Selector is 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: http://releases.k8s.io/release-1.4/docs/user-guide/labels.md#label-selectors
- optional LabelSelector selector = 1;
- // Template is the 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: http://releases.k8s.io/release-1.4/docs/user-guide/replication-controller.md#pod-template
- optional k8s.io.kubernetes.pkg.api.v1.PodTemplateSpec template = 2;
- }
- // DaemonSetStatus represents the current status of a daemon set.
- message DaemonSetStatus {
- // CurrentNumberScheduled is the number of nodes that are running at least 1
- // daemon pod and are supposed to run the daemon pod.
- // More info: http://releases.k8s.io/release-1.4/docs/admin/daemons.md
- optional int32 currentNumberScheduled = 1;
- // NumberMisscheduled is the number of nodes that are running the daemon pod, but are
- // not supposed to run the daemon pod.
- // More info: http://releases.k8s.io/release-1.4/docs/admin/daemons.md
- optional int32 numberMisscheduled = 2;
- // DesiredNumberScheduled is the total number of nodes that should be running the daemon
- // pod (including nodes correctly running the daemon pod).
- // More info: http://releases.k8s.io/release-1.4/docs/admin/daemons.md
- optional int32 desiredNumberScheduled = 3;
- }
- // Deployment enables declarative updates for Pods and ReplicaSets.
- message Deployment {
- // Standard object metadata.
- optional k8s.io.kubernetes.pkg.api.v1.ObjectMeta metadata = 1;
- // Specification of the desired behavior of the Deployment.
- optional DeploymentSpec spec = 2;
- // Most recently observed status of the Deployment.
- optional DeploymentStatus status = 3;
- }
- // DeploymentList is a list of Deployments.
- message DeploymentList {
- // Standard list metadata.
- optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
- // Items is the list of Deployments.
- repeated Deployment items = 2;
- }
- // 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
- 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 int32 replicas = 1;
- // Label selector for pods. Existing ReplicaSets whose pods are
- // selected by this will be the ones affected by this deployment.
- optional LabelSelector selector = 2;
- // Template describes the pods that will be created.
- optional k8s.io.kubernetes.pkg.api.v1.PodTemplateSpec template = 3;
- // The deployment strategy to use to replace existing pods with new ones.
- 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 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.
- optional int32 revisionHistoryLimit = 6;
- // Indicates that the deployment is paused and will not be processed by the
- // deployment controller.
- optional bool paused = 7;
- // The config this deployment is rolling back to. Will be cleared after rollback is done.
- optional RollbackConfig rollbackTo = 8;
- }
- // DeploymentStatus is the most recently observed status of the Deployment.
- message DeploymentStatus {
- // The generation observed by the deployment controller.
- optional int64 observedGeneration = 1;
- // Total number of non-terminated pods targeted by this deployment (their labels match the selector).
- optional int32 replicas = 2;
- // Total number of non-terminated pods targeted by this deployment that have the desired template spec.
- optional int32 updatedReplicas = 3;
- // Total number of available pods (ready for at least minReadySeconds) targeted by this deployment.
- optional int32 availableReplicas = 4;
- // Total number of unavailable pods targeted by this deployment.
- optional int32 unavailableReplicas = 5;
- }
- // DeploymentStrategy describes how to replace existing pods with new ones.
- message DeploymentStrategy {
- // Type of deployment. Can be "Recreate" or "RollingUpdate". Default is RollingUpdate.
- 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 RollingUpdateDeployment rollingUpdate = 2;
- }
- // ExportOptions is the query options to the standard REST get call.
- message ExportOptions {
- // Should this value be exported. Export strips fields that a user can not specify.
- optional bool export = 1;
- // Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'
- optional bool exact = 2;
- }
- // FSGroupStrategyOptions defines the strategy type and options used to create the strategy.
- message FSGroupStrategyOptions {
- // Rule is the strategy that will dictate what FSGroup is used in the SecurityContext.
- optional string rule = 1;
- // Ranges are the allowed ranges of fs groups. If you would like to force a single
- // fs group then supply a single range with the same start and end.
- repeated IDRange ranges = 2;
- }
- // HTTPIngressPath associates a path regex with a backend. Incoming urls matching
- // the path are forwarded to the backend.
- message HTTPIngressPath {
- // Path is an extended POSIX regex as defined by IEEE Std 1003.1,
- // (i.e this follows the egrep/unix syntax, not the perl syntax)
- // 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 '/'. If unspecified, the path defaults to a catch all sending
- // traffic to the backend.
- optional string path = 1;
- // 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;
- }
- // configuration of a horizontal pod autoscaler.
- message HorizontalPodAutoscaler {
- // Standard object metadata. More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.v1.ObjectMeta metadata = 1;
- // behaviour of autoscaler. More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#spec-and-status.
- optional HorizontalPodAutoscalerSpec spec = 2;
- // current information about the autoscaler.
- optional HorizontalPodAutoscalerStatus status = 3;
- }
- // list of horizontal pod autoscaler objects.
- message HorizontalPodAutoscalerList {
- // Standard list metadata.
- optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
- // list of horizontal pod autoscaler objects.
- repeated HorizontalPodAutoscaler items = 2;
- }
- // specification of a horizontal pod autoscaler.
- message HorizontalPodAutoscalerSpec {
- // reference to Scale subresource; horizontal pod autoscaler will learn the current resource consumption from its status,
- // and will set the desired number of pods by modifying its spec.
- optional SubresourceReference scaleRef = 1;
- // lower limit for the number of pods that can be set by the autoscaler, default 1.
- optional int32 minReplicas = 2;
- // upper limit for the number of pods that can be set by the autoscaler; cannot be smaller than MinReplicas.
- optional int32 maxReplicas = 3;
- // target average CPU utilization (represented as a percentage of requested CPU) over all the pods;
- // if not specified it defaults to the target CPU utilization at 80% of the requested resources.
- optional CPUTargetUtilization cpuUtilization = 4;
- }
- // current status of a horizontal pod autoscaler
- message HorizontalPodAutoscalerStatus {
- // most recent generation observed by this autoscaler.
- optional int64 observedGeneration = 1;
- // last time the HorizontalPodAutoscaler scaled the number of pods;
- // used by the autoscaler to control how often the number of pods is changed.
- optional k8s.io.kubernetes.pkg.api.unversioned.Time lastScaleTime = 2;
- // current number of replicas of pods managed by this autoscaler.
- optional int32 currentReplicas = 3;
- // desired number of replicas of pods managed by this autoscaler.
- optional int32 desiredReplicas = 4;
- // current average CPU utilization over all pods, represented as a percentage of requested CPU,
- // e.g. 70 means that an average pod is using now 70% of its requested CPU.
- optional int32 currentCPUUtilizationPercentage = 5;
- }
- // Host Port Range defines a range of host ports that will be enabled by a policy
- // for pods to use. It requires both the start and end to be defined.
- message HostPortRange {
- // min is the start of the range, inclusive.
- optional int32 min = 1;
- // max is the end of the range, inclusive.
- optional int32 max = 2;
- }
- // ID Range provides a min/max of an allowed range of IDs.
- message IDRange {
- // Min is the start of the range, inclusive.
- optional int64 min = 1;
- // Max is the end of the range, inclusive.
- optional int64 max = 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.
- message Ingress {
- // Standard object's metadata.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.v1.ObjectMeta metadata = 1;
- // Spec is the desired state of the Ingress.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#spec-and-status
- optional IngressSpec spec = 2;
- // Status is the current state of the Ingress.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#spec-and-status
- optional IngressStatus status = 3;
- }
- // IngressBackend describes all endpoints for a given service and port.
- message IngressBackend {
- // Specifies the name of the referenced service.
- optional string serviceName = 1;
- // Specifies the port of the referenced service.
- optional k8s.io.kubernetes.pkg.util.intstr.IntOrString servicePort = 2;
- }
- // IngressList is a collection of Ingress.
- message IngressList {
- // Standard object's metadata.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
- // Items is the list of Ingress.
- repeated Ingress items = 2;
- }
- // 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 the RFC:
- // 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.
- 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 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 {
- optional HTTPIngressRuleValue http = 1;
- }
- // IngressSpec describes the Ingress the user wishes to exist.
- message IngressSpec {
- // 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 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.
- 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.
- repeated IngressRule rules = 3;
- }
- // IngressStatus describe the current state of the Ingress.
- message IngressStatus {
- // LoadBalancer contains the current status of the load-balancer.
- optional k8s.io.kubernetes.pkg.api.v1.LoadBalancerStatus 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.
- 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 string secretName = 2;
- }
- // Job represents the configuration of a single job.
- message Job {
- // Standard object's metadata.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.v1.ObjectMeta metadata = 1;
- // Spec is a structure defining the expected behavior of a job.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#spec-and-status
- optional JobSpec spec = 2;
- // Status is a structure describing current status of a job.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#spec-and-status
- optional JobStatus status = 3;
- }
- // JobCondition describes current state of a job.
- message JobCondition {
- // Type of job condition, Complete or Failed.
- optional string type = 1;
- // Status of the condition, one of True, False, Unknown.
- optional string status = 2;
- // Last time the condition was checked.
- optional k8s.io.kubernetes.pkg.api.unversioned.Time lastProbeTime = 3;
- // Last time the condition transit from one status to another.
- optional k8s.io.kubernetes.pkg.api.unversioned.Time lastTransitionTime = 4;
- // (brief) reason for the condition's last transition.
- optional string reason = 5;
- // Human readable message indicating details about last transition.
- optional string message = 6;
- }
- // JobList is a collection of jobs.
- message JobList {
- // Standard list metadata
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
- // Items is the list of Job.
- repeated Job items = 2;
- }
- // JobSpec describes how the job execution will look like.
- message JobSpec {
- // Parallelism specifies the maximum desired number of pods the job should
- // run at any given time. The actual number of pods running in steady state will
- // be less than this number when ((.spec.completions - .status.successful) < .spec.parallelism),
- // i.e. when the work left to do is less than max parallelism.
- // More info: http://releases.k8s.io/release-1.4/docs/user-guide/jobs.md
- optional int32 parallelism = 1;
- // Completions specifies the desired number of successfully finished pods the
- // job should be run with. Setting to nil means that the success of any
- // pod signals the success of all pods, and allows parallelism to have any positive
- // value. Setting to 1 means that parallelism is limited to 1 and the success of that
- // pod signals the success of the job.
- // More info: http://releases.k8s.io/release-1.4/docs/user-guide/jobs.md
- optional int32 completions = 2;
- // Optional duration in seconds relative to the startTime that the job may be active
- // before the system tries to terminate it; value must be positive integer
- optional int64 activeDeadlineSeconds = 3;
- // Selector is a label query over pods that should match the pod count.
- // Normally, the system sets this field for you.
- // More info: http://releases.k8s.io/release-1.4/docs/user-guide/labels.md#label-selectors
- optional LabelSelector selector = 4;
- // AutoSelector controls generation of pod labels and pod selectors.
- // It was not present in the original extensions/v1beta1 Job definition, but exists
- // to allow conversion from batch/v1 Jobs, where it corresponds to, but has the opposite
- // meaning as, ManualSelector.
- // More info: http://releases.k8s.io/release-1.4/docs/design/selector-generation.md
- optional bool autoSelector = 5;
- // Template is the object that describes the pod that will be created when
- // executing a job.
- // More info: http://releases.k8s.io/release-1.4/docs/user-guide/jobs.md
- optional k8s.io.kubernetes.pkg.api.v1.PodTemplateSpec template = 6;
- }
- // JobStatus represents the current state of a Job.
- message JobStatus {
- // Conditions represent the latest available observations of an object's current state.
- // More info: http://releases.k8s.io/release-1.4/docs/user-guide/jobs.md
- repeated JobCondition conditions = 1;
- // StartTime represents time when the job was acknowledged by the Job Manager.
- // It is not guaranteed to be set in happens-before order across separate operations.
- // It is represented in RFC3339 form and is in UTC.
- optional k8s.io.kubernetes.pkg.api.unversioned.Time startTime = 2;
- // CompletionTime represents time when the job was completed. It is not guaranteed to
- // be set in happens-before order across separate operations.
- // It is represented in RFC3339 form and is in UTC.
- optional k8s.io.kubernetes.pkg.api.unversioned.Time completionTime = 3;
- // Active is the number of actively running pods.
- optional int32 active = 4;
- // Succeeded is the number of pods which reached Phase Succeeded.
- optional int32 succeeded = 5;
- // Failed is the number of pods which reached Phase Failed.
- optional int32 failed = 6;
- }
- // A label selector is a label query over a set of resources. The result of matchLabels and
- // matchExpressions are ANDed. An empty label selector matches all objects. A null
- // label selector matches no objects.
- message LabelSelector {
- // matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
- // map is equivalent to an element of matchExpressions, whose key field is "key", the
- // operator is "In", and the values array contains only "value". The requirements are ANDed.
- map<string, string> matchLabels = 1;
- // matchExpressions is a list of label selector requirements. The requirements are ANDed.
- repeated LabelSelectorRequirement matchExpressions = 2;
- }
- // A label selector requirement is a selector that contains values, a key, and an operator that
- // relates the key and values.
- message LabelSelectorRequirement {
- // key is the label key that the selector applies to.
- optional string key = 1;
- // operator represents a key's relationship to a set of values.
- // Valid operators ard In, NotIn, Exists and DoesNotExist.
- optional string operator = 2;
- // values is an array of string values. If the operator is In or NotIn,
- // the values array must be non-empty. If the operator is Exists or DoesNotExist,
- // the values array must be empty. This array is replaced during a strategic
- // merge patch.
- repeated string values = 3;
- }
- // ListOptions is the query options to a standard REST list call.
- message ListOptions {
- // A selector to restrict the list of returned objects by their labels.
- // Defaults to everything.
- optional string labelSelector = 1;
- // A selector to restrict the list of returned objects by their fields.
- // Defaults to everything.
- optional string fieldSelector = 2;
- // Watch for changes to the described resources and return them as a stream of
- // add, update, and remove notifications. Specify resourceVersion.
- optional bool watch = 3;
- // When specified with a watch call, shows changes that occur after that particular version of a resource.
- // Defaults to changes from the beginning of history.
- optional string resourceVersion = 4;
- // Timeout for the list/watch call.
- optional int64 timeoutSeconds = 5;
- }
- message NetworkPolicy {
- // Standard object's metadata.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.v1.ObjectMeta metadata = 1;
- // Specification of the desired behavior for this NetworkPolicy.
- optional NetworkPolicySpec spec = 2;
- }
- // 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 not provided, this rule matches all ports (traffic not restricted by port).
- // If this field is empty, this rule matches no ports (no traffic matches).
- // 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.
- // TODO: Update this to be a pointer to slice as soon as auto-generation supports it.
- 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 not provided, this rule matches all sources (traffic not restricted by source).
- // If this field is empty, this rule matches no sources (no traffic matches).
- // If this field is present and contains at least on item, this rule allows traffic only if the
- // traffic matches at least one item in the from list.
- // TODO: Update this to be a pointer to slice as soon as auto-generation supports it.
- repeated NetworkPolicyPeer from = 2;
- }
- // Network Policy List is a list of NetworkPolicy objects.
- message NetworkPolicyList {
- // Standard list metadata.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
- // Items is a list of schema objects.
- repeated NetworkPolicy items = 2;
- }
- message NetworkPolicyPeer {
- // This is a label selector which selects Pods in this namespace.
- // This field follows standard label selector semantics.
- // If not provided, this selector selects no pods.
- // If present but empty, this selector selects all pods in this namespace.
- optional LabelSelector podSelector = 1;
- // Selects Namespaces using cluster scoped-labels. This
- // matches all pods in all namespaces selected by this label selector.
- // This field follows standard label selector semantics.
- // If omitted, this selector selects no namespaces.
- // If present but empty, this selector selects all namespaces.
- optional LabelSelector namespaceSelector = 2;
- }
- message NetworkPolicyPort {
- // Optional. The protocol (TCP or UDP) which traffic must match.
- // If not specified, this field defaults to TCP.
- optional string protocol = 1;
- // If specified, 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 k8s.io.kubernetes.pkg.util.intstr.IntOrString port = 2;
- }
- 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 LabelSelector podSelector = 1;
- // List of ingress rules to be applied to the selected pods.
- // Traffic is allowed to a pod if namespace.networkPolicy.ingress.isolation is undefined and cluster policy allows it,
- // 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 affect ingress isolation.
- // If this field is present and contains at least one rule, this policy allows any traffic
- // which matches at least one of the ingress rules in this list.
- repeated NetworkPolicyIngressRule ingress = 2;
- }
- // Pod Security Policy governs the ability to make requests that affect the Security Context
- // that will be applied to a pod and container.
- message PodSecurityPolicy {
- // Standard object's metadata.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.v1.ObjectMeta metadata = 1;
- // spec defines the policy enforced.
- optional PodSecurityPolicySpec spec = 2;
- }
- // Pod Security Policy List is a list of PodSecurityPolicy objects.
- message PodSecurityPolicyList {
- // Standard list metadata.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
- // Items is a list of schema objects.
- repeated PodSecurityPolicy items = 2;
- }
- // Pod Security Policy Spec defines the policy enforced.
- message PodSecurityPolicySpec {
- // privileged determines if a pod can request to be run as privileged.
- optional bool privileged = 1;
- // DefaultAddCapabilities is the default set of capabilities that will be added to the container
- // unless the pod spec specifically drops the capability. You may not list a capabiility in both
- // DefaultAddCapabilities and RequiredDropCapabilities.
- repeated string defaultAddCapabilities = 2;
- // RequiredDropCapabilities are the capabilities that will be dropped from the container. These
- // are required to be dropped and cannot be added.
- repeated string requiredDropCapabilities = 3;
- // AllowedCapabilities is a list of capabilities that can be requested to add to the container.
- // Capabilities in this field may be added at the pod author's discretion.
- // You must not list a capability in both AllowedCapabilities and RequiredDropCapabilities.
- repeated string allowedCapabilities = 4;
- // volumes is a white list of allowed volume plugins. Empty indicates that all plugins
- // may be used.
- repeated string volumes = 5;
- // hostNetwork determines if the policy allows the use of HostNetwork in the pod spec.
- optional bool hostNetwork = 6;
- // hostPorts determines which host port ranges are allowed to be exposed.
- repeated HostPortRange hostPorts = 7;
- // hostPID determines if the policy allows the use of HostPID in the pod spec.
- optional bool hostPID = 8;
- // hostIPC determines if the policy allows the use of HostIPC in the pod spec.
- optional bool hostIPC = 9;
- // seLinux is the strategy that will dictate the allowable labels that may be set.
- optional SELinuxStrategyOptions seLinux = 10;
- // runAsUser is the strategy that will dictate the allowable RunAsUser values that may be set.
- optional RunAsUserStrategyOptions runAsUser = 11;
- // SupplementalGroups is the strategy that will dictate what supplemental groups are used by the SecurityContext.
- optional SupplementalGroupsStrategyOptions supplementalGroups = 12;
- // FSGroup is the strategy that will dictate what fs group is used by the SecurityContext.
- optional FSGroupStrategyOptions fsGroup = 13;
- // ReadOnlyRootFilesystem when set to true will force containers to run with a read only root file
- // system. If the container specifically requests to run with a non-read only root file system
- // the PSP should deny the pod.
- // If set to false the container may run with a read only root file system if it wishes but it
- // will not be forced to.
- optional bool readOnlyRootFilesystem = 14;
- }
- // ReplicaSet represents the configuration of a ReplicaSet.
- 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: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.v1.ObjectMeta metadata = 1;
- // Spec defines the specification of the desired behavior of the ReplicaSet.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#spec-and-status
- 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: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#spec-and-status
- optional ReplicaSetStatus status = 3;
- }
- // ReplicaSetList is a collection of ReplicaSets.
- message ReplicaSetList {
- // Standard list metadata.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#types-kinds
- optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
- // List of ReplicaSets.
- // More info: http://releases.k8s.io/release-1.4/docs/user-guide/replication-controller.md
- 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: http://releases.k8s.io/release-1.4/docs/user-guide/replication-controller.md#what-is-a-replication-controller
- optional int32 replicas = 1;
- // 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: http://releases.k8s.io/release-1.4/docs/user-guide/labels.md#label-selectors
- optional LabelSelector selector = 2;
- // Template is the object that describes the pod that will be created if
- // insufficient replicas are detected.
- // More info: http://releases.k8s.io/release-1.4/docs/user-guide/replication-controller.md#pod-template
- optional k8s.io.kubernetes.pkg.api.v1.PodTemplateSpec template = 3;
- }
- // ReplicaSetStatus represents the current status of a ReplicaSet.
- message ReplicaSetStatus {
- // Replicas is the most recently oberved number of replicas.
- // More info: http://releases.k8s.io/release-1.4/docs/user-guide/replication-controller.md#what-is-a-replication-controller
- optional int32 replicas = 1;
- // The number of pods that have labels matching the labels of the pod template of the replicaset.
- optional int32 fullyLabeledReplicas = 2;
- // The number of ready replicas for this replica set.
- optional int32 readyReplicas = 4;
- // ObservedGeneration reflects the generation of the most recently observed ReplicaSet.
- optional int64 observedGeneration = 3;
- }
- // Dummy definition
- message ReplicationControllerDummy {
- }
- message RollbackConfig {
- // The revision to rollback to. If set to 0, rollbck to the last revision.
- optional int64 revision = 1;
- }
- // 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 up.
- // 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 k8s.io.kubernetes.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 atmost 130% of desired pods.
- optional k8s.io.kubernetes.pkg.util.intstr.IntOrString maxSurge = 2;
- }
- // Run A sUser Strategy Options defines the strategy type and any options used to create the strategy.
- message RunAsUserStrategyOptions {
- // Rule is the strategy that will dictate the allowable RunAsUser values that may be set.
- optional string rule = 1;
- // Ranges are the allowed ranges of uids that may be used.
- repeated IDRange ranges = 2;
- }
- // SELinux Strategy Options defines the strategy type and any options used to create the strategy.
- message SELinuxStrategyOptions {
- // type is the strategy that will dictate the allowable labels that may be set.
- optional string rule = 1;
- // seLinuxOptions required to run as; required for MustRunAs
- // More info: http://releases.k8s.io/release-1.4/docs/design/security_context.md#security-context
- optional k8s.io.kubernetes.pkg.api.v1.SELinuxOptions seLinuxOptions = 2;
- }
- // represents a scaling request for a resource.
- message Scale {
- // Standard object metadata; More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata.
- optional k8s.io.kubernetes.pkg.api.v1.ObjectMeta metadata = 1;
- // defines the behavior of the scale. More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#spec-and-status.
- optional ScaleSpec spec = 2;
- // current status of the scale. More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#spec-and-status. Read-only.
- optional ScaleStatus status = 3;
- }
- // describes the attributes of a scale subresource
- message ScaleSpec {
- // desired number of instances for the scaled object.
- 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;
- // label query over pods that should match the replicas count. More info: http://releases.k8s.io/release-1.4/docs/user-guide/labels.md#label-selectors
- 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: http://releases.k8s.io/release-1.4/docs/user-guide/labels.md#label-selectors
- optional string targetSelector = 3;
- }
- // StorageClass describes the parameters for a class of storage for
- // which PersistentVolumes can be dynamically provisioned.
- //
- // StorageClasses are non-namespaced; the name of the storage class
- // according to etcd is in ObjectMeta.Name.
- message StorageClass {
- // Standard object's metadata.
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.v1.ObjectMeta metadata = 1;
- // Provisioner indicates the type of the provisioner.
- optional string provisioner = 2;
- // Parameters holds the parameters for the provisioner that should
- // create volumes of this storage class.
- map<string, string> parameters = 3;
- }
- // StorageClassList is a collection of storage classes.
- message StorageClassList {
- // Standard list metadata
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
- // Items is the list of StorageClasses
- repeated StorageClass items = 2;
- }
- // SubresourceReference contains enough information to let you inspect or modify the referred subresource.
- message SubresourceReference {
- // Kind of the referent; More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#types-kinds
- optional string kind = 1;
- // Name of the referent; More info: http://releases.k8s.io/release-1.4/docs/user-guide/identifiers.md#names
- optional string name = 2;
- // API version of the referent
- optional string apiVersion = 3;
- // Subresource name of the referent
- optional string subresource = 4;
- }
- // SupplementalGroupsStrategyOptions defines the strategy type and options used to create the strategy.
- message SupplementalGroupsStrategyOptions {
- // Rule is the strategy that will dictate what supplemental groups is used in the SecurityContext.
- optional string rule = 1;
- // Ranges are the allowed ranges of supplemental groups. If you would like to force a single
- // supplemental group then supply a single range with the same start and end.
- repeated IDRange ranges = 2;
- }
- // A ThirdPartyResource is a generic representation of a resource, it is used by add-ons and plugins to add new resource
- // types to the API. It consists of one or more Versions of the api.
- message ThirdPartyResource {
- // Standard object metadata
- optional k8s.io.kubernetes.pkg.api.v1.ObjectMeta metadata = 1;
- // Description is the description of this object.
- optional string description = 2;
- // Versions are versions for this third party object
- repeated APIVersion versions = 3;
- }
- // An internal object, used for versioned storage in etcd. Not exposed to the end user.
- message ThirdPartyResourceData {
- // Standard object metadata.
- optional k8s.io.kubernetes.pkg.api.v1.ObjectMeta metadata = 1;
- // Data is the raw JSON data for this data.
- optional bytes data = 2;
- }
- // ThirdPartyResrouceDataList is a list of ThirdPartyResourceData.
- message ThirdPartyResourceDataList {
- // Standard list metadata
- // More info: http://releases.k8s.io/release-1.4/docs/devel/api-conventions.md#metadata
- optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
- // Items is the list of ThirdpartyResourceData.
- repeated ThirdPartyResourceData items = 2;
- }
- // ThirdPartyResourceList is a list of ThirdPartyResources.
- message ThirdPartyResourceList {
- // Standard list metadata.
- optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
- // Items is the list of ThirdPartyResources.
- repeated ThirdPartyResource items = 2;
- }
|