Package errors provides detailed error types for api field validation.

Package latest defines the default output serializations that code should use and imports the required schemas.

Package meta provides functions for retrieving API metadata from objects belonging to the Kubernetes API.

Package testapi provides a helper for retrieving the KUBE_API_VERSION environment variable.

Package v1beta1 is the v1beta1 version of the API.

Package v1beta2 is the v1beta2 version of the API.

Package v1beta3 is the v1beta3 version of the API.

Package validation has functions for validating the correctness of api objects and explaining what is wrong with them when they aren't valid.

FillObjectMetaSystemFields populates fields that are managed by the system on ObjectMeta.

GetPartialReference is exactly like GetReference, but allows you to set the FieldPath.

GetReference returns an ObjectReference which refers to the given object, or an error if the object doesn't follow the conventions that would allow this.

HasObjectMetaSystemFieldValues returns true if fields that are managed by the system on ObjectMeta have values.

Namespace returns the value of the namespace key on the ctx, or the empty string if none.

NamespaceFrom returns the value of the namespace key on the ctx.

NewContext instantiates a base context object for request flows.

NewDefaultContext instantiates a base context object for request flows in the default namespace.

ValidNamespace returns false if the namespace on the context differs from the resource.

WithNamespace returns a copy of parent in which the namespace value is set.

WithNamespaceDefaultIfNone returns a context whose namespace is the default if and only if the parent context has no namespace value.

WithValue returns a copy of parent in which the value associated with key is val.

CauseTypeFieldValueDuplicate is used to report collisions of values that must be unique (e.g.

CauseTypeFieldValueInvalid is used to report malformed values (e.g.

CauseTypeFieldValueNotFound is used to report failure to find a requested value (e.g.

CauseTypeFieldValueNotSupported is used to report valid (as per formatting rules) values that can not be handled (e.g.

CauseTypeFieldValueRequired is used to report required values that are not provided (e.g.

These are valid condition status.

These are valid condition status.

These are valid condition status.

NamespaceAll is the default argument to specify on a context when you want to list or filter resources across all namespaces.

NamespaceDefault means the object is in the default namespace which is applied when not specified by clients.

NodePending means the node has been created/added by the system, but not configured.

NodeReachable means the node can be reached (in the sense of HTTP connection) from node controller.

NodeReady means the node returns StatusOK for HTTP health check.

NodeRunning means the node has been configured and has Kubernetes components running.

NodeTerminated means the node has been removed from the cluster.

PodFailed means that all containers in the pod have terminated, and at least one container has terminated in a failure (exited with a non-zero exit code or was stopped by the system).

PodPending means the pod has been accepted by the system, but one or more of the containers has not been started.

PodRunning means the pod has been bound to a node and all of the containers have been started.

PodSucceeded means that all containers in the pod have voluntarily terminated with a container exit code of 0, and the system is not going to restart any of these containers.

ProtocolTCP is the TCP protocol.

ProtocolUDP is the UDP protocol.

PullAlways means that kubelet always attempts to pull the latest image.

PullIfNotPresent means that kubelet pulls if the image isn't present on disk.

PullNever means that kubelet never pulls an image, but only uses a local image.

Values of Status.Status.

StatusReasonAlreadyExists means the resource you are creating already exists.

StatusReasonBadRequest means that the request itself was invalid, because the request doesn't make any sense, for example deleting a read-only object.

StatusReasonConflict means the requested update operation cannot be completed due to a conflict in the operation.

StatusReasonInternalError indicates that an internal error occurred, it is unexpected and the outcome of the call is unknown.

StatusReasonInvalid means the requested create or update operation cannot be completed due to invalid data provided as part of the request.

StatusReasonNotFound means one or more resources required for this operation could not be found.

StatusReasonUnknown means the server has declined to indicate a specific reason.

StatusReasonWorking means the server is processing this request and will complete at a future time.

Values of Status.Status.

Values of Status.Status.

TerminationMessagePathDefault means the default path to capture the application termination message running in a container.

Codec is the identity codec for this package - it can only convert itself to itself.

Errors that could be returned by GetReference.

ForTesting_ReferencesAllowBlankSelfLinks can be set to true in tests to avoid "ErrNoSelfLink" errors.

Scheme is the default instance of runtime.Scheme to which types in the Kubernetes API are already registered.

APIVersions lists the api versions that are available, to allow version negotiation.

Binding is written by a scheduler to cause a pod to be bound to a host.

BoundPod is a collection of containers that should be run on a host.

BoundPods is a list of Pods bound to a common server.

Container represents a single container that is expected to be run on the host.

ContainerManifest corresponds to the Container Manifest format, documented at: https://developers.google.com/compute/docs/containers/container_vms#container_manifest This is used as the representation of Kubernetes workloads.

ContainerManifestList is used to communicate container manifests to kubelet.

ContainerState holds a possible state of container.

Endpoints is a collection of endpoints that implement the actual service, for example: Name: "mysql", Endpoints: ["10.10.1.1:1909", "10.10.2.2:8834"].

EndpointsList is a list of endpoints.

EnvVar represents an environment variable present in a Container.

Event is a report of an event somewhere in the cluster.

EventList is a list of events.

ExecAction describes a "run in container" action.

GCEPersistentDisk represents a Persistent Disk resource in Google Compute Engine.

GitRepo represents a volume that is pulled from git when the pod is created.

Handler defines a specific action that should be taken TODO: pass structured data to these actions, and document that data here.

HostDir represents bare host directory volume.

HTTPGetAction describes an action based on HTTP Get requests.

Lifecycle describes actions that the management system should take in response to container lifecycle events.

List holds a list of objects, which may not be known by the server.

ListMeta describes metadata that synthetic resources must have, including lists and various status objects.

LivenessProbe describes a liveness probe to be examined to the container.

Node is a worker node in Kubernetenes The name of the node according to etcd is in ObjectMeta.Name.

NodeList is a list of minions.

NodeResources is an object for conveying resource information about a node.

NodeSpec describes the attributes that a node is created with.

NodeStatus is information about the current status of a node.

ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

ObjectReference contains enough information to let you inspect or modify the referred object.

Operation is an operation delivered to API clients.

OperationList is a list of operations, as delivered to API clients.

Pod is a collection of containers, used as either input (create, update) or as output (list, get).

PodContainerInfo is a wrapper for PodInfo that can be encode/decoded.

PodList is a list of Pods.

PodSpec is a description of a pod.

PodStatus represents information about the status of a pod.

PodTemplate describes a template for creating copies of a predefined pod.

PodTemplateList is a list of PodTemplates.

PodTemplateSpec describes the data a pod should have when created from a template.

Port represents a network port in a single container.

ReplicationController represents the configuration of a replication controller.

ReplicationControllerList is a collection of replication controllers.

ReplicationControllerSpec is the specification of a replication controller.

ReplicationControllerStatus represents the current status of a replication controller.

RestartPolicy describes how the container should be restarted.

TODO(dchen1107): Define what kinds of failures should restart.

Service is a named abstraction of software service (for example, mysql) consisting of local port (for example 3306) that the proxy listens on, and the selector that determines which pods will answer requests sent through the proxy.

ServiceList holds a list of services.

ServiceSpec describes the attributes that a user creates on a service.

ServiceStatus represents the current status of a service.

Status is a return value for calls that don't return other objects.

StatusCause provides more information about an api.Status failure, including cases when multiple errors are encountered.

StatusDetails is a set of additional properties that MAY be set by the server to provide additional information about a response.

TCPSocketAction describes an action based on opening a socket.

TypeMeta describes an individual object in an API response or request with strings representing the type of the object and its API schema version.

Volume represents a named volume in a pod that may be accessed by any containers in the pod.

VolumeMount describes a mounting of a Volume within a container.

VolumeSource represents the source location of a valume to mount.

Context carries values across API boundaries.

CauseType is a machine readable value providing more detail about what occured in a status response.

PodInfo contains one entry for every container with available info.

PodPhase is a label for the condition of a pod at the current time.

Protocol defines network protocols supported for things like conatiner ports.

PullPolicy describes a policy for if/when to pull a container image.

StatusReason is an enumeration of possible failure causes.