Setup chainctl

This action installs the chainctl binary for a particular environment and authenticates with it using identity tokens. By default it installs the latest release; pass version to pin a specific one.

Usage

- uses: chainguard-dev/setup-chainctl@[VERSION]
  with:
    # the ID of the identity this workload should assume when speaking to Chainguard APIs.
    identity: "..."
    # optionally pin the chainctl version to install (defaults to latest)
    # version: "0.2.313"

Scenarios

permissions:
  id-token: write

steps:
- uses: chainguard-dev/setup-chainctl@[VERSION]
  with:
    identity: "deadbeef/badf00d"

See Authenticating to Chainguard Registry for more information about creating an identity to pull images from cgr.dev from GitHub Actions, using setup-chainctl.

Runner Support

The action is tested to work on Linux, MacOS and Windows runners.

Note: If you use it on Windows, you must use shell: bash.