github/kubernetes
1
0
Fork 0
mirror of https://github.com/k3s-io/kubernetes.git synced 2026-01-04 23:17:50 +00:00
Code Issues Projects Releases Wiki Activity

Replace references to http://releases.k8s.io/HEAD/docs/user-guide/

Browse Source
This commit is contained in:
Ilya Dmitrichenko
2016-09-27 16:41:29 +01:00
parent 4f27c740fa
commit abc0a98d25
57 changed files with 1387 additions and 1387 deletions
Download Patch File Download Diff File Expand all files Collapse all files

192
pkg/api/v1/generated.proto
View File

@@ -37,13 +37,13 @@ option go_package = "v1";
// ownership management and SELinux relabeling.
message AWSElasticBlockStoreVolumeSource {
// Unique ID of the persistent disk resource in AWS (Amazon EBS volume).
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#awselasticblockstore
// More info: http://kubernetes.io/docs/user-guide/volumes#awselasticblockstore
optional string volumeID = 1;
// Filesystem type of the volume that you want to mount.
// Tip: Ensure that the filesystem type is supported by the host operating system.
// Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#awselasticblockstore
// More info: http://kubernetes.io/docs/user-guide/volumes#awselasticblockstore
// TODO: how do we prevent errors in the filesystem from compromising the machine
optional string fsType = 2;
@@ -55,7 +55,7 @@ message AWSElasticBlockStoreVolumeSource {
// Specify "true" to force and set the ReadOnly property in VolumeMounts to "true".
// If omitted, the default is "false".
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#awselasticblockstore
// More info: http://kubernetes.io/docs/user-guide/volumes#awselasticblockstore
optional bool readOnly = 4;
}
@@ -294,7 +294,7 @@ message Container {
optional string name = 1;
// Docker image name.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/images.md
// More info: http://kubernetes.io/docs/user-guide/images
optional string image = 2;
// Entrypoint array. Not executed within a shell.
@@ -304,7 +304,7 @@ message Container {
// can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
// regardless of whether the variable exists or not.
// Cannot be updated.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/containers.md#containers-and-commands
// More info: http://kubernetes.io/docs/user-guide/containers#containers-and-commands
repeated string command = 3;
// Arguments to the entrypoint.
@@ -314,7 +314,7 @@ message Container {
// can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
// regardless of whether the variable exists or not.
// Cannot be updated.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/containers.md#containers-and-commands
// More info: http://kubernetes.io/docs/user-guide/containers#containers-and-commands
repeated string args = 4;
// Container's working directory.
@@ -338,7 +338,7 @@ message Container {
// Compute Resources required by this container.
// Cannot be updated.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#resources
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#resources
optional ResourceRequirements resources = 8;
// Pod volumes to mount into the container's filesystem.
@@ -348,13 +348,13 @@ message Container {
// Periodic probe of container liveness.
// Container will be restarted if the probe fails.
// Cannot be updated.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#container-probes
// More info: http://kubernetes.io/docs/user-guide/pod-states#container-probes
optional Probe livenessProbe = 10;
// Periodic probe of container service readiness.
// Container will be removed from service endpoints if the probe fails.
// Cannot be updated.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#container-probes
// More info: http://kubernetes.io/docs/user-guide/pod-states#container-probes
optional Probe readinessProbe = 11;
// Actions that the management system should take in response to container lifecycle events.
@@ -372,7 +372,7 @@ message Container {
// One of Always, Never, IfNotPresent.
// Defaults to Always if :latest tag is specified, or IfNotPresent otherwise.
// Cannot be updated.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/images.md#updating-images
// More info: http://kubernetes.io/docs/user-guide/images#updating-images
optional string imagePullPolicy = 14;
// Security options the pod should run with.
@@ -508,7 +508,7 @@ message ContainerStatus {
optional int32 restartCount = 5;
// The image the container is running.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/images.md
// More info: http://kubernetes.io/docs/user-guide/images
// TODO(dchen1107): Which image the container is running with?
optional string image = 6;
@@ -516,7 +516,7 @@ message ContainerStatus {
optional string imageID = 7;
// Container's ID in the format 'docker://<container_id>'.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/container-environment.md#container-information
// More info: http://kubernetes.io/docs/user-guide/container-environment#container-information
optional string containerID = 8;
}
@@ -582,7 +582,7 @@ message EmptyDirVolumeSource {
// What type of storage medium should back this directory.
// The default is "" which means to use the node's default medium.
// Must be an empty string (default) or Memory.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#emptydir
// More info: http://kubernetes.io/docs/user-guide/volumes#emptydir
optional string medium = 1;
}
@@ -859,13 +859,13 @@ message FlockerVolumeSource {
// PDs support ownership management and SELinux relabeling.
message GCEPersistentDiskVolumeSource {
// Unique name of the PD resource in GCE. Used to identify the disk in GCE.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#gcepersistentdisk
// More info: http://kubernetes.io/docs/user-guide/volumes#gcepersistentdisk
optional string pdName = 1;
// Filesystem type of the volume that you want to mount.
// Tip: Ensure that the filesystem type is supported by the host operating system.
// Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#gcepersistentdisk
// More info: http://kubernetes.io/docs/user-guide/volumes#gcepersistentdisk
// TODO: how do we prevent errors in the filesystem from compromising the machine
optional string fsType = 2;
@@ -873,12 +873,12 @@ message GCEPersistentDiskVolumeSource {
// If omitted, the default is to mount by volume name.
// Examples: For volume /dev/sda1, you specify the partition as "1".
// Similarly, the volume partition for /dev/sda is "0" (or you can leave the property empty).
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#gcepersistentdisk
// More info: http://kubernetes.io/docs/user-guide/volumes#gcepersistentdisk
optional int32 partition = 3;
// ReadOnly here will force the ReadOnly setting in VolumeMounts.
// Defaults to false.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#gcepersistentdisk
// More info: http://kubernetes.io/docs/user-guide/volumes#gcepersistentdisk
optional bool readOnly = 4;
}
@@ -967,7 +967,7 @@ message Handler {
// Host path volumes do not support ownership management or SELinux relabeling.
message HostPathVolumeSource {
// Path of the directory on the host.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#hostpath
// More info: http://kubernetes.io/docs/user-guide/volumes#hostpath
optional string path = 1;
}
@@ -991,7 +991,7 @@ message ISCSIVolumeSource {
// Filesystem type of the volume that you want to mount.
// Tip: Ensure that the filesystem type is supported by the host operating system.
// Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#iscsi
// More info: http://kubernetes.io/docs/user-guide/volumes#iscsi
// TODO: how do we prevent errors in the filesystem from compromising the machine
optional string fsType = 5;
@@ -1025,7 +1025,7 @@ message Lifecycle {
// PostStart is called immediately after a container is created. If the handler fails,
// the container is terminated and restarted according to its restart policy.
// Other management of the container blocks until the hook completes.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/container-environment.md#hook-details
// More info: http://kubernetes.io/docs/user-guide/container-environment#hook-details
optional Handler postStart = 1;
// PreStop is called immediately before a container is terminated.
@@ -1033,7 +1033,7 @@ message Lifecycle {
// The reason for termination is passed to the handler.
// Regardless of the outcome of the handler, the container is eventually terminated.
// Other management of the container blocks until the hook completes.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/container-environment.md#hook-details
// More info: http://kubernetes.io/docs/user-guide/container-environment#hook-details
optional Handler preStop = 2;
}
@@ -1141,7 +1141,7 @@ message LoadBalancerStatus {
// referenced object inside the same namespace.
message LocalObjectReference {
// Name of the referent.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#names
// More info: http://kubernetes.io/docs/user-guide/identifiers#names
// TODO: Add other useful fields. apiVersion, kind, uid?
optional string name = 1;
}
@@ -1150,17 +1150,17 @@ message LocalObjectReference {
// NFS volumes do not support ownership management or SELinux relabeling.
message NFSVolumeSource {
// Server is the hostname or IP address of the NFS server.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#nfs
// More info: http://kubernetes.io/docs/user-guide/volumes#nfs
optional string server = 1;
// Path that is exported by the NFS server.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#nfs
// More info: http://kubernetes.io/docs/user-guide/volumes#nfs
optional string path = 2;
// ReadOnly here will force
// the NFS export to be mounted with read-only permissions.
// Defaults to false.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#nfs
// More info: http://kubernetes.io/docs/user-guide/volumes#nfs
optional bool readOnly = 3;
}
@@ -1187,7 +1187,7 @@ message NamespaceList {
optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
// Items is the list of Namespace objects in the list.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/namespaces.md
// More info: http://kubernetes.io/docs/user-guide/namespaces
repeated Namespace items = 2;
}
@@ -1348,7 +1348,7 @@ message NodeSpec {
// NodeStatus is information about the current status of a node.
message NodeStatus {
// Capacity represents the total resources of a node.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#capacity for more details.
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#capacity for more details.
map<string, k8s.io.kubernetes.pkg.api.resource.Quantity> capacity = 1;
// Allocatable represents the resources of a node that are available for scheduling.
@@ -1440,7 +1440,7 @@ message ObjectMeta {
// automatically. Name is primarily intended for creation idempotence and configuration
// definition.
// Cannot be updated.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#names
// More info: http://kubernetes.io/docs/user-guide/identifiers#names
optional string name = 1;
// GenerateName is an optional prefix, used by the server, to generate a unique
@@ -1467,7 +1467,7 @@ message ObjectMeta {
//
// Must be a DNS_LABEL.
// Cannot be updated.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/namespaces.md
// More info: http://kubernetes.io/docs/user-guide/namespaces
optional string namespace = 3;
// SelfLink is a URL representing this object.
@@ -1481,7 +1481,7 @@ message ObjectMeta {
//
// Populated by the system.
// Read-only.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#uids
// More info: http://kubernetes.io/docs/user-guide/identifiers#uids
optional string uid = 5;
// An opaque value that represents the internal version of this object that can
@@ -1535,13 +1535,13 @@ message ObjectMeta {
// Map of string keys and values that can be used to organize and categorize
// (scope and select) objects. May match selectors of replication controllers
// and services.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/labels.md
// More info: http://kubernetes.io/docs/user-guide/labels
map<string, string> labels = 11;
// Annotations is an unstructured key value map stored with a resource that may be
// set by external tools to store and retrieve arbitrary metadata. They are not
// queryable and should be preserved when modifying objects.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/annotations.md
// More info: http://kubernetes.io/docs/user-guide/annotations
map<string, string> annotations = 12;
// List of objects depended by this object. If ALL objects in the list have
@@ -1569,15 +1569,15 @@ message ObjectReference {
optional string kind = 1;
// Namespace of the referent.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/namespaces.md
// More info: http://kubernetes.io/docs/user-guide/namespaces
optional string namespace = 2;
// Name of the referent.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#names
// More info: http://kubernetes.io/docs/user-guide/identifiers#names
optional string name = 3;
// UID of the referent.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#uids
// More info: http://kubernetes.io/docs/user-guide/identifiers#uids
optional string uid = 4;
// API version of the referent.
@@ -1610,11 +1610,11 @@ message OwnerReference {
optional string kind = 1;
// Name of the referent.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#names
// More info: http://kubernetes.io/docs/user-guide/identifiers#names
optional string name = 3;
// UID of the referent.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#uids
// More info: http://kubernetes.io/docs/user-guide/identifiers#uids
optional string uid = 4;
// If true, this reference points to the managing controller.
@@ -1623,7 +1623,7 @@ message OwnerReference {
// PersistentVolume (PV) is a storage resource provisioned by an administrator.
// It is analogous to a node.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes
message PersistentVolume {
// Standard object's metadata.
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata
@@ -1631,13 +1631,13 @@ message PersistentVolume {
// Spec defines a specification of a persistent volume owned by the cluster.
// Provisioned by an administrator.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistent-volumes
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#persistent-volumes
optional PersistentVolumeSpec spec = 2;
// Status represents the current information/status for the persistent volume.
// Populated by the system.
// Read-only.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistent-volumes
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#persistent-volumes
optional PersistentVolumeStatus status = 3;
}
@@ -1648,12 +1648,12 @@ message PersistentVolumeClaim {
optional ObjectMeta metadata = 1;
// Spec defines the desired characteristics of a volume requested by a pod author.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistentvolumeclaims
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#persistentvolumeclaims
optional PersistentVolumeClaimSpec spec = 2;
// Status represents the current information/status of a persistent volume claim.
// Read-only.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistentvolumeclaims
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#persistentvolumeclaims
optional PersistentVolumeClaimStatus status = 3;
}
@@ -1664,7 +1664,7 @@ message PersistentVolumeClaimList {
optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
// A list of persistent volume claims.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistentvolumeclaims
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#persistentvolumeclaims
repeated PersistentVolumeClaim items = 2;
}
@@ -1672,14 +1672,14 @@ message PersistentVolumeClaimList {
// and allows a Source for provider-specific attributes
message PersistentVolumeClaimSpec {
// AccessModes contains the desired access modes the volume should have.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#access-modes-1
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#access-modes-1
repeated string accessModes = 1;
// A label query over volumes to consider for binding.
optional k8s.io.kubernetes.pkg.api.unversioned.LabelSelector selector = 4;
// Resources represents the minimum resources the volume should have.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#resources
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#resources
optional ResourceRequirements resources = 2;
// VolumeName is the binding reference to the PersistentVolume backing this claim.
@@ -1692,7 +1692,7 @@ message PersistentVolumeClaimStatus {
optional string phase = 1;
// AccessModes contains the actual access modes the volume backing the PVC has.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#access-modes-1
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#access-modes-1
repeated string accessModes = 2;
// Represents the actual resources of the underlying volume.
@@ -1705,7 +1705,7 @@ message PersistentVolumeClaimStatus {
// type of volume that is owned by someone else (the system).
message PersistentVolumeClaimVolumeSource {
// ClaimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistentvolumeclaims
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#persistentvolumeclaims
optional string claimName = 1;
// Will force the ReadOnly setting in VolumeMounts.
@@ -1720,7 +1720,7 @@ message PersistentVolumeList {
optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
// List of persistent volumes.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes
repeated PersistentVolume items = 2;
}
@@ -1729,19 +1729,19 @@ message PersistentVolumeList {
message PersistentVolumeSource {
// GCEPersistentDisk represents a GCE Disk resource that is attached to a
// kubelet's host machine and then exposed to the pod. Provisioned by an admin.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#gcepersistentdisk
// More info: http://kubernetes.io/docs/user-guide/volumes#gcepersistentdisk
optional GCEPersistentDiskVolumeSource gcePersistentDisk = 1;
// AWSElasticBlockStore represents an AWS Disk resource that is attached to a
// kubelet's host machine and then exposed to the pod.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#awselasticblockstore
// More info: http://kubernetes.io/docs/user-guide/volumes#awselasticblockstore
optional AWSElasticBlockStoreVolumeSource awsElasticBlockStore = 2;
// HostPath represents a directory on the host.
// Provisioned by a developer or tester.
// This is useful for single-node development and testing only!
// On-host storage is not supported in any way and WILL NOT WORK in a multi-node cluster.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#hostpath
// More info: http://kubernetes.io/docs/user-guide/volumes#hostpath
optional HostPathVolumeSource hostPath = 3;
// Glusterfs represents a Glusterfs volume that is attached to a host and
@@ -1750,7 +1750,7 @@ message PersistentVolumeSource {
optional GlusterfsVolumeSource glusterfs = 4;
// NFS represents an NFS mount on the host. Provisioned by an admin.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#nfs
// More info: http://kubernetes.io/docs/user-guide/volumes#nfs
optional NFSVolumeSource nfs = 5;
// RBD represents a Rados Block Device mount on the host that shares a pod's lifetime.
@@ -1795,33 +1795,33 @@ message PersistentVolumeSource {
// PersistentVolumeSpec is the specification of a persistent volume.
message PersistentVolumeSpec {
// A description of the persistent volume's resources and capacity.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#capacity
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#capacity
map<string, k8s.io.kubernetes.pkg.api.resource.Quantity> capacity = 1;
// The actual volume backing the persistent volume.
optional PersistentVolumeSource persistentVolumeSource = 2;
// AccessModes contains all ways the volume can be mounted.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#access-modes
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#access-modes
repeated string accessModes = 3;
// ClaimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim.
// Expected to be non-nil when bound.
// claim.VolumeName is the authoritative bind between PV and PVC.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#binding
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#binding
optional ObjectReference claimRef = 4;
// What happens to a persistent volume when released from its claim.
// Valid options are Retain (default) and Recycle.
// Recycling must be supported by the volume plugin underlying this persistent volume.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#recycling-policy
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#recycling-policy
optional string persistentVolumeReclaimPolicy = 5;
}
// PersistentVolumeStatus is the current status of a persistent volume.
message PersistentVolumeStatus {
// Phase indicates if a volume is available, bound to a claim, or released by a claim.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#phase
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#phase
optional string phase = 1;
// A human-readable message indicating details about why the volume is in this state.
@@ -1973,12 +1973,12 @@ message PodAttachOptions {
message PodCondition {
// Type is the type of the condition.
// Currently only Ready.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#pod-conditions
// More info: http://kubernetes.io/docs/user-guide/pod-states#pod-conditions
optional string type = 1;
// Status is the status of the condition.
// Can be True, False, Unknown.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#pod-conditions
// More info: http://kubernetes.io/docs/user-guide/pod-states#pod-conditions
optional string status = 2;
// Last time we probed the condition.
@@ -2030,7 +2030,7 @@ message PodList {
optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
// List of pods.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/pods.md
// More info: http://kubernetes.io/docs/user-guide/pods
repeated Pod items = 2;
}
@@ -2130,20 +2130,20 @@ message PodSignature {
// PodSpec is a description of a pod.
message PodSpec {
// List of volumes that can be mounted by containers belonging to the pod.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md
// More info: http://kubernetes.io/docs/user-guide/volumes
repeated Volume volumes = 1;
// List of containers belonging to the pod.
// Containers cannot currently be added or removed.
// There must be at least one container in a Pod.
// Cannot be updated.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/containers.md
// More info: http://kubernetes.io/docs/user-guide/containers
repeated Container containers = 2;
// Restart policy for all containers within the pod.
// One of Always, OnFailure, Never.
// Default to Always.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#restartpolicy
// More info: http://kubernetes.io/docs/user-guide/pod-states#restartpolicy
optional string restartPolicy = 3;
// Optional duration in seconds the pod needs to terminate gracefully. May be decreased in delete request.
@@ -2167,7 +2167,7 @@ message PodSpec {
// NodeSelector is a selector which must be true for the pod to fit on a node.
// Selector which must match a node's labels for the pod to be scheduled on that node.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/node-selection/README.md
// More info: http://kubernetes.io/docs/user-guide/node-selection/README
map<string, string> nodeSelector = 7;
// ServiceAccountName is the name of the ServiceAccount to use to run this pod.
@@ -2207,7 +2207,7 @@ message PodSpec {
// ImagePullSecrets is an optional list of references to secrets in the same namespace to use for pulling any of the images used by this PodSpec.
// If specified, these secrets will be passed to individual puller implementations for them to use. For example,
// in the case of docker, only DockerConfig type secrets are honored.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/images.md#specifying-imagepullsecrets-on-a-pod
// More info: http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod
repeated LocalObjectReference imagePullSecrets = 15;
// Specifies the hostname of the Pod
@@ -2223,11 +2223,11 @@ message PodSpec {
// state of a system.
message PodStatus {
// Current condition of the pod.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#pod-phase
// More info: http://kubernetes.io/docs/user-guide/pod-states#pod-phase
optional string phase = 1;
// Current service state of pod.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#pod-conditions
// More info: http://kubernetes.io/docs/user-guide/pod-states#pod-conditions
repeated PodCondition conditions = 2;
// A human readable message indicating details about why the pod is in this condition.
@@ -2250,7 +2250,7 @@ message PodStatus {
// The list has one entry per container in the manifest. Each entry is currently the output
// of `docker inspect`.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#container-statuses
// More info: http://kubernetes.io/docs/user-guide/pod-states#container-statuses
repeated ContainerStatus containerStatuses = 8;
}
@@ -2338,12 +2338,12 @@ message Probe {
optional Handler handler = 1;
// Number of seconds after the container has started before liveness probes are initiated.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#container-probes
// More info: http://kubernetes.io/docs/user-guide/pod-states#container-probes
optional int32 initialDelaySeconds = 2;
// Number of seconds after which the probe times out.
// Defaults to 1 second. Minimum value is 1.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#container-probes
// More info: http://kubernetes.io/docs/user-guide/pod-states#container-probes
optional int32 timeoutSeconds = 3;
// How often (in seconds) to perform the probe.
@@ -2397,7 +2397,7 @@ message RBDVolumeSource {
// Filesystem type of the volume that you want to mount.
// Tip: Ensure that the filesystem type is supported by the host operating system.
// Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#rbd
// More info: http://kubernetes.io/docs/user-guide/volumes#rbd
// TODO: how do we prevent errors in the filesystem from compromising the machine
optional string fsType = 3;
@@ -2467,7 +2467,7 @@ message ReplicationControllerList {
optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
// List of replication controllers.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md
// More info: http://kubernetes.io/docs/user-guide/replication-controller
repeated ReplicationController items = 2;
}
@@ -2476,7 +2476,7 @@ message ReplicationControllerSpec {
// 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/HEAD/docs/user-guide/replication-controller.md#what-is-a-replication-controller
// More info: http://kubernetes.io/docs/user-guide/replication-controller#what-is-a-replication-controller
optional int32 replicas = 1;
// Minimum number of seconds for which a newly created pod should be ready
@@ -2488,12 +2488,12 @@ message ReplicationControllerSpec {
// If 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 replication
// controller, if empty defaulted to labels on Pod template.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/labels.md#label-selectors
// More info: http://kubernetes.io/docs/user-guide/labels#label-selectors
map<string, string> selector = 2;
// Template is the object that describes the pod that will be created if
// insufficient replicas are detected. This takes precedence over a TemplateRef.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md#pod-template
// More info: http://kubernetes.io/docs/user-guide/replication-controller#pod-template
optional PodTemplateSpec template = 3;
}
@@ -2501,7 +2501,7 @@ message ReplicationControllerSpec {
// controller.
message ReplicationControllerStatus {
// Replicas is the most recently oberved number of replicas.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md#what-is-a-replication-controller
// More info: http://kubernetes.io/docs/user-guide/replication-controller#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 replication controller.
@@ -2645,7 +2645,7 @@ message SecretList {
optional k8s.io.kubernetes.pkg.api.unversioned.ListMeta metadata = 1;
// Items is a list of secret objects.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/secrets.md
// More info: http://kubernetes.io/docs/user-guide/secrets
repeated Secret items = 2;
}
@@ -2656,7 +2656,7 @@ message SecretList {
// Secret volumes support ownership management and SELinux relabeling.
message SecretVolumeSource {
// Name of the secret in the pod's namespace to use.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#secrets
// More info: http://kubernetes.io/docs/user-guide/volumes#secrets
optional string secretName = 1;
// If unspecified, each key-value pair in the Data field of the referenced
@@ -2749,13 +2749,13 @@ message ServiceAccount {
optional ObjectMeta metadata = 1;
// Secrets is the list of secrets allowed to be used by pods running using this ServiceAccount.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/secrets.md
// More info: http://kubernetes.io/docs/user-guide/secrets
repeated ObjectReference secrets = 2;
// ImagePullSecrets is a list of references to secrets in the same namespace to use for pulling any images
// in pods that reference this ServiceAccount. ImagePullSecrets are distinct from Secrets because Secrets
// can be mounted in the pod, but ImagePullSecrets are only accessed by the kubelet.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/secrets.md#manually-specifying-an-imagepullsecret
// More info: http://kubernetes.io/docs/user-guide/secrets#manually-specifying-an-imagepullsecret
repeated LocalObjectReference imagePullSecrets = 3;
}
@@ -2802,14 +2802,14 @@ message ServicePort {
// of the 'port' field is used (an identity map).
// This field is ignored for services with clusterIP=None, and should be
// omitted or set equal to the 'port' field.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/services.md#defining-a-service
// More info: http://kubernetes.io/docs/user-guide/services#defining-a-service
optional k8s.io.kubernetes.pkg.util.intstr.IntOrString targetPort = 4;
// The port on each node on which this service is exposed when type=NodePort or LoadBalancer.
// Usually assigned by the system. If specified, it will be allocated to the service
// if unused or else creation of the service will fail.
// Default is to auto-allocate a port if the ServiceType of this Service requires one.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/services.md#type--nodeport
// More info: http://kubernetes.io/docs/user-guide/services#type--nodeport
optional int32 nodePort = 5;
}
@@ -2826,7 +2826,7 @@ message ServiceProxyOptions {
// ServiceSpec describes the attributes that a user creates on a service.
message ServiceSpec {
// The list of ports that are exposed by this service.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/services.md#virtual-ips-and-service-proxies
// More info: http://kubernetes.io/docs/user-guide/services#virtual-ips-and-service-proxies
repeated ServicePort ports = 1;
// Route service traffic to pods with label keys and values matching this
@@ -2834,7 +2834,7 @@ message ServiceSpec {
// external process managing its endpoints, which Kubernetes will not
// modify. Only applies to types ClusterIP, NodePort, and LoadBalancer.
// Ignored if type is ExternalName.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/services.md#overview
// More info: http://kubernetes.io/docs/user-guide/services#overview
map<string, string> selector = 2;
// clusterIP is the IP address of the service and is usually assigned
@@ -2845,7 +2845,7 @@ message ServiceSpec {
// can be specified for headless services when proxying is not required.
// Only applies to types ClusterIP, NodePort, and LoadBalancer. Ignored if
// type is ExternalName.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/services.md#virtual-ips-and-service-proxies
// More info: http://kubernetes.io/docs/user-guide/services#virtual-ips-and-service-proxies
optional string clusterIP = 3;
// type determines how the Service is exposed. Defaults to ClusterIP. Valid
@@ -2861,7 +2861,7 @@ message ServiceSpec {
// "LoadBalancer" builds on NodePort and creates an
// external load-balancer (if supported in the current cloud) which routes
// to the clusterIP.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/services.md#overview
// More info: http://kubernetes.io/docs/user-guide/services#overview
optional string type = 4;
// externalIPs is a list of IP addresses for which nodes in the cluster
@@ -2885,7 +2885,7 @@ message ServiceSpec {
// Enable client IP based session affinity.
// Must be ClientIP or None.
// Defaults to None.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/services.md#virtual-ips-and-service-proxies
// More info: http://kubernetes.io/docs/user-guide/services#virtual-ips-and-service-proxies
optional string sessionAffinity = 7;
// Only applies to Service Type: LoadBalancer
@@ -2898,7 +2898,7 @@ message ServiceSpec {
// If specified and supported by the platform, this will restrict traffic through the cloud-provider
// load-balancer will be restricted to the specified client IPs. This field will be ignored if the
// cloud-provider does not support the feature."
// More info: http://releases.k8s.io/HEAD/docs/user-guide/services-firewalls.md
// More info: http://kubernetes.io/docs/user-guide/services-firewalls
repeated string loadBalancerSourceRanges = 9;
// externalName is the external reference that kubedns or equivalent will
@@ -2962,7 +2962,7 @@ message Toleration {
message Volume {
// Volume's name.
// Must be a DNS_LABEL and unique within the pod.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#names
// More info: http://kubernetes.io/docs/user-guide/identifiers#names
optional string name = 1;
// VolumeSource represents the location and type of the mounted volume.
@@ -2996,35 +2996,35 @@ message VolumeSource {
// machine that is directly exposed to the container. This is generally
// used for system agents or other privileged things that are allowed
// to see the host machine. Most containers will NOT need this.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#hostpath
// More info: http://kubernetes.io/docs/user-guide/volumes#hostpath
// ---
// TODO(jonesdl) We need to restrict who can use host directory mounts and who can/can not
// mount host directories as read/write.
optional HostPathVolumeSource hostPath = 1;
// EmptyDir represents a temporary directory that shares a pod's lifetime.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#emptydir
// More info: http://kubernetes.io/docs/user-guide/volumes#emptydir
optional EmptyDirVolumeSource emptyDir = 2;
// GCEPersistentDisk represents a GCE Disk resource that is attached to a
// kubelet's host machine and then exposed to the pod.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#gcepersistentdisk
// More info: http://kubernetes.io/docs/user-guide/volumes#gcepersistentdisk
optional GCEPersistentDiskVolumeSource gcePersistentDisk = 3;
// AWSElasticBlockStore represents an AWS Disk resource that is attached to a
// kubelet's host machine and then exposed to the pod.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#awselasticblockstore
// More info: http://kubernetes.io/docs/user-guide/volumes#awselasticblockstore
optional AWSElasticBlockStoreVolumeSource awsElasticBlockStore = 4;
// GitRepo represents a git repository at a particular revision.
optional GitRepoVolumeSource gitRepo = 5;
// Secret represents a secret that should populate this volume.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#secrets
// More info: http://kubernetes.io/docs/user-guide/volumes#secrets
optional SecretVolumeSource secret = 6;
// NFS represents an NFS mount on the host that shares a pod's lifetime
// More info: http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#nfs
// More info: http://kubernetes.io/docs/user-guide/volumes#nfs
optional NFSVolumeSource nfs = 7;
// ISCSI represents an ISCSI Disk resource that is attached to a
@@ -3038,7 +3038,7 @@ message VolumeSource {
// PersistentVolumeClaimVolumeSource represents a reference to a
// PersistentVolumeClaim in the same namespace.
// More info: http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistentvolumeclaims
// More info: http://kubernetes.io/docs/user-guide/persistent-volumes#persistentvolumeclaims
optional PersistentVolumeClaimVolumeSource persistentVolumeClaim = 10;
// RBD represents a Rados Block Device mount on the host that shares a pod's lifetime.