CloudBees action: Copy Docker images with Crane

Use this action to copy a remote image from a source to a Docker destination with Crane, a tool for managing container images. This action also reports artifact-related data to the workflow run for artifact traceability purposes.

Prerequisites

Before invoking the action, you must have a Docker config file in the ${HOME}/.docker/config.json path. This file is used to authenticate with the Docker registry.

Use either of the below actions to generate a Docker config file.

The OCI credentials configuration action.
The ECR credentials configuration action, for authenticating to an AWS ECR registry.

If your source and destination registries are different, you must authenticate to both registries. Invoke the Docker registry authentication action separately for those registries before invoking the Crane action.

All CloudBees action repositories are listed at CloudBees, Inc. on GitHub.

Inputs

Table 1. Input details
Input name	Data type	Required?	Description
`destination`	String	Yes	The destination image.
`src`	String	Yes	The source image to copy.
`platform`	String	No	Specifies the platform in the format `os/arch[/variant][:osversion]`.
`skip-image-validation`	String	No	Default is `true`. When `true`, the source and destination image validation is skipped.

Usage example

In your YAML file, add:

      - name: Copy remote image with Crane
        uses: cloudbees-io/crane@v1
        with:
          src: <source registry>/<image name>:<source image tag>
          destination: <destination registry>/<image name>:<destination image tag>
          platform: linux/amd64
          skip-image-validation: 'false'▼