Docker Image
- Docker image artifact in the UI
  - In a trigger
  - In a pipeline stage
- Docker image artifact in a pipeline definition

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:

Field	Explanation
Account	A Docker registry artifact account.
Docker image	The 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.

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.

Docker image artifact in a pipeline definition

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

Field	Explanation
`type`	Always `docker/image`.
`reference`	The 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`.
`name`	The image’s name (typically the registry and repository) without the image’s version. Example: `gcr.io/project/my-image`
`version`	The image’s tag or digest.
`location`	N/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"
}

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