https://github.com/chainguard-dev/setup-chainctl

GitHub Action to install chainctl in your workflow
https://github.com/chainguard-dev/setup-chainctl

actions chainguard ci-cd github-actions

Last synced: about 2 months ago
JSON representation

GitHub Action to install chainctl in your workflow

• Host: GitHub
• URL: https://github.com/chainguard-dev/setup-chainctl
• Owner: chainguard-dev
• License: apache-2.0
• Created: 2024-03-01T23:42:03.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-01-22T14:27:00.000Z (4 months ago)
• Last Synced: 2025-03-22T00:05:26.933Z (2 months ago)
• Topics: actions, chainguard, ci-cd, github-actions
• Homepage:
• Size: 35.2 KB
• Stars: 1
• Watchers: 4
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Setup `chainctl`

[![Test](https://github.com/chainguard-dev/setup-chainctl/actions/workflows/test.yaml/badge.svg)](https://github.com/chainguard-dev/setup-chainctl/actions/workflows/test.yaml)

This action installs the latest `chainctl` binary for a particular environment

and authenticates with it using identity tokens.

## Usage

```yaml

- uses: chainguard-dev/setup-chainctl@[VERSION]

  with:

    # the ID of the identity this workload should assume when speaking to Chainguard APIs.

    identity: "..."

```

## Scenarios

```yaml

permissions:

  id-token: write

steps:

- uses: chainguard-dev/setup-chainctl@[VERSION]

  with:

    identity: "deadbeef/badf00d"

```

See [Authenticating to Chainguard Registry](https://edu.chainguard.dev/chainguard/chainguard-images/registry/authenticating/#authenticating-with-github-actions) 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`.