Harbor CLI Setup
ActionsTags
(2)
A GitHub Action that downloads, verifies, and installs the Harbor CLI tool from official GitHub releases, or optionally builds it from the latest main branch.
This action downloads a pre-built Harbor CLI binary for the current runner platform, verifies its SHA-256 checksum against the official checksums.txt published with every release, and adds it to PATH. It supports both specific versions and the latest release.
Alternatively, set build_from_source: 'true' to build from source instead of downloading a pre-built binary. Works with any version value, a release tag, latest, or main. Requires Go to be set up in your workflow before calling this action.
- 🚀 Download any version of Harbor CLI or the latest release
- 🔒 SHA-256 checksum verification against the official
checksums.txt - 🔨 Optional source build — any release tag or
main - ✅ Automatic version validation
- 🎯 Cross-platform support (Linux, macOS, Windows — amd64 & arm64)
- ⚡ No Go toolchain required for binary installs
| Input | Description | Required | Default |
|---|---|---|---|
version |
Semver tag (e.g. v0.0.19), latest, or main. main is only valid when build_from_source is true. |
No | latest |
build_from_source |
Build from source instead of downloading a pre-built binary. Works with any version value: release tag, latest, or main. Requires Go to be set up before calling this action. |
No | false |
| Output | Description |
|---|---|
version |
The version/tag that was installed or built |
path |
Full path to the harbor-cli binary |
steps:
- uses: actions/checkout@v4
- name: Setup Harbor CLI
uses: qcserestipy/harbor-cli-setup@0.0.2
id: harbor-cli
- name: Use Harbor CLI
run: |
harbor-cli versionsteps:
- uses: actions/checkout@v4
- name: Setup Harbor CLI
uses: qcserestipy/harbor-cli-setup@0.0.2
id: harbor-cli
with:
version: 'v0.0.19'
- name: Use Harbor CLI
run: |
echo "Installed version: ${{ steps.harbor-cli.outputs.version }}"
harbor-cli --helpsteps:
- uses: actions/checkout@v4
- name: Setup Go
uses: actions/setup-go@v6
with:
go-version: '1.26.x'
- name: Setup Harbor CLI (from source)
uses: qcserestipy/harbor-cli-setup@0.0.2
id: harbor-cli
with:
version: 'v0.0.19'
build_from_source: 'true'
- name: Use Harbor CLI
run: harbor-cli versionsteps:
- uses: actions/checkout@v4
- name: Setup Go
uses: actions/setup-go@v6
with:
go-version: '1.26.x'
- name: Setup Harbor CLI (from main)
uses: qcserestipy/harbor-cli-setup@0.0.2
id: harbor-cli
with:
version: 'main'
build_from_source: 'true'
- name: Use Harbor CLI
run: harbor-cli versionname: Harbor Deployment
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Harbor CLI
uses: qcserestipy/harbor-cli-setup@0.0.2
id: harbor-cli
with:
version: 'latest'
- name: Configure Harbor CLI
run: |
harbor-cli login ${{ secrets.HARBOR_URL }} \
--username ${{ secrets.HARBOR_USERNAME }} \
--password ${{ secrets.HARBOR_PASSWORD }}
- name: List Artifacts
run: |
harbor-cli artifact list <project_name>/<repository_name> -ojson- Internet access to reach
github.com build_from_sourceonly: Go must be set up in your workflow before calling this action (e.g. viaactions/setup-go)
The action will fail in the following scenarios:
- Invalid version: The specified tag does not exist in the Harbor CLI repository
- Checksum mismatch: The downloaded archive does not match the SHA-256 digest in
checksums.txt - Unsupported platform: The runner OS or architecture has no matching release asset
- Build failure: The Go build fails (source build only)
| Runner | Architecture |
|---|---|
ubuntu-* |
amd64, arm64 |
macos-* |
amd64 (Intel), arm64 (Apple Silicon) |
windows-* |
amd64, arm64 |
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the Apache 2.0 License - see the LICENSE file for details.
If you encounter any issues or have questions, please open an issue in this repository.
Harbor CLI Setup is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.
Tags
(2)Harbor CLI Setup is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.