regclient actions

This repo contains various GitHub actions for regclient.

regctl-installer

This action installs the regctl binary.

regctl-installer Usage

- name: Install regctluses: regclient/actions/regctl-installer@mainwith:
release: 'v0.4.7'# optional version

regctl-installer Inputs

The following inputs are available for regctl-installer:

Input	Description
release	regctl version to use. Defaults to latest (most recent release). Set to main to build the latest commit using go install.
install-dir	directory to place the regctl binary into instead of the default ($HOME/.regctl/bin).

If cosign is installed, signatures on downloaded binaries will be verified.

regsync-installer

This action installs the regsync binary.

regsync-installer Usage

- name: Install regsyncuses: regclient/actions/regsync-installer@mainwith:
release: 'v0.4.7'# optional version

regsync-installer Inputs

The following inputs are available for regsync-installer:

Input	Description
release	regsync version to use. Defaults to latest (most recent release). Set to main to build the latest commit using go install.
install-dir	directory to place the regsync binary into instead of the default ($HOME/.regsync/bin).

If cosign is installed, signatures on downloaded binaries will be verified.

regbot-installer

This action installs the regbot binary.

regbot-installer Usage

- name: Install regbotuses: regclient/actions/regbot-installer@mainwith:
release: 'v0.4.7'# optional version

regbot-installer Inputs

The following inputs are available for regbot-installer:

Input	Description
release	regbot version to use. Defaults to latest (most recent release). Set to main to build the latest commit using go install.
install-dir	directory to place the regbot binary into instead of the default ($HOME/.regbot/bin).

If cosign is installed, signatures on downloaded binaries will be verified.

regctl-login

This action performs a login to a registry, similar to docker login.

regctl-login Usage

- name: regctl loginuses: regclient/actions/regctl-login@main

regctl-login Inputs

The following inputs are available for regctl-login:

Input	Description
registry	Registry to use. Defaults to ghcr.io. Use docker.io to login to Docker Hub.
username	Username for the login. Defaults to ${{ github.actor }}.
password	Password for the login. Defaults to ${{ github.token }}.

Examples

Install latest release of regctl:

jobs:
example:
runs-on: ubuntu-latestname: examplesteps:
# if cosign is installed, signatures will be verified
- name: Install cosignuses: sigstore/cosign-installer@main
- name: Install regctluses: regclient/actions/regctl-installer@main
- name: regctl loginuses: regclient/actions/regctl-login@main

Install from main branch using go install, and login to Docker Hub using a secret:

jobs:
example:
runs-on: ubuntu-latestname: examplesteps:
- name: Set up Gouses: actions/setup-go@v6
- name: Install regctluses: regclient/actions/regctl-installer@mainwith:
release: 'main'
- name: regctl loginuses: regclient/actions/regctl-login@mainwith:
registry: docker.iousername: ${{ secrets.DOCKERHUB_USERNAME }}password: ${{ secrets.DOCKERHUB_TOKEN }}

Project Details

For more details on the regclient project, see regclient/regclient.