Kubernetes Object

Kubernetes Object artifacts are running, deployed Kubernetes manifests. This is in contrast to something like a GitHub file that only contains the specification of a deployable Kubernetes manifest.

Kubernetes object artifact in the UI

The pipeline UI exposes the following fields for the Kubernetes object artifact:

FieldExplanation
AccountAn HTTP artifact account.
URLThe fully-qualified URL from which the file can be read.

Kubernetes object artifact in a pipeline definition

The following are the fields that make up a Kubernetes object artifact:

FieldExplanation
typekubernetes/<kind>, where <kind> is the Kubernetes Kind (such as Deployment).
referenceThe name of the object.
nameThe name of the object.
versionThe version of the object. Only set if the resource was deployed with a version (for example, a ConfigMap deployed at version -v120).
locationThe namespace of the object.
artifactAccountThe Spinnaker account (Kubernetes context) to which the object was deployed.

The following is an example JSON representation of a Kubernetes object artifact, as it would appear in a pipeline definition:

  1. {
  2. "type": "kubernetes/deployment",
  3. "reference": "frontend",
  4. "name": "frontend",
  5. "namespace": "staging",
  6. "artifactAccount": "gke-us-central1-xnat"
  7. }

Last modified July 1, 2021: docs(fix): fix internal links (#98) (d74c3a4)