Docker Image

Docker image artifacts are references to images in registries, such as GCR or Docker Hub.

The artifacts can be deployed to Kubernetes or App Engine, and generally trigger pipelines from notifications sent by their registry.

Docker image artifact in the UI

The pipeline UI exposes the following fields for the Docker image artifact:

FieldExplanation
AccountA Docker registry artifact account.
Docker imageThe name of the Docker image, including the registry and image repository.

In a trigger

When configuring the Docker Registry trigger, you can use a Docker image as an expected artifact.

Configuring Docker image fields in a pipeline trigger’s expected artifact settings.

Configuring Docker image fields in a pipeline trigger’s expected artifact settings.

In a pipeline stage

When configuring certain stages, such as a “Deploy (Manifest)” stage, you can use a Docker image as a required artifact. You can either use a previously-defined artifact (for example, an artifact defined in a trigger) or define an artifact inline.

Configuring a Deploy (Manifest) stage to use a Docker image as a required artifact.

Configuring a Deploy (Manifest) stage to use a Docker image as a required artifact.

Docker image artifact in a pipeline definition

The following are the fields that make up a Docker image artifact:

FieldExplanation
typeAlways docker/image.
referenceThe fully-qualified image name, including the version and registry. This can be done by either tag (gcr.io/project/my-image:v1.2) or image digest gcr.io/project/my-image@sha256:28f82eba.
nameThe image’s name (typically the registry and repository) without the image’s version. Example: gcr.io/project/my-image
versionThe image’s tag or digest.
locationN/A

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

{
  "type": "docker/image",
  "reference": "gcr.io/project/my-image@sha256:28f82eba",
  "name": "gcr.io/project/my-image",
  "version": "sha256:28f82eba"
}