GitHub Action that installs the Epinio CLI, caches it, adds it to PATH, and optionally logs in.
name: Deploy with Epinio
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
permissions:
contents: read
steps:
- uses: actions/checkout@v4
- name: Setup Epinio
id: epinio
uses: epinio/setup-epinio-action@v1
with:
version: latest
url: ${{ secrets.EPINIO_URL }}
# Prefer token auth in CI (password is not passed on the CLI)
token: ${{ secrets.EPINIO_TOKEN }}
namespace: workspace
# github-token defaults to ${{ github.token }} (needed for version: latest)
- run: epinio app listPinned semver installs without a GitHub API call (download URL is built directly):
- uses: epinio/setup-epinio-action@v1
with:
version: "1.14.2"- uses: epinio/setup-epinio-action@v1
with:
version: server
url: ${{ secrets.EPINIO_URL }}Token auth is recommended in CI. If you must use user/password:
- uses: epinio/setup-epinio-action@v1
with:
url: ${{ secrets.EPINIO_URL }}
user: ${{ secrets.EPINIO_USER }}
password: ${{ secrets.EPINIO_PASSWORD }}
namespace: workspace
# Required for self-signed / private CA (user/password login only)
trust-ca: true| Name | Required | Default | Description |
|---|---|---|---|
version |
no | latest |
latest, pinned semver (1.14.2 / v1.14.2), or server |
url |
no | Epinio API URL (login and/or version: server) |
|
token |
no | Bearer access token (preferred over user/password in CI) | |
user |
no | Username (requires password + url) |
|
password |
no | Password (requires user + url) |
|
namespace |
no | Namespace to target after authentication | |
trust-ca |
no | false |
Pass --trust-ca on user/password login only |
github-token |
no | ${{ github.token }} |
Used when resolving version: latest via the GitHub API |
| Name | Description |
|---|---|
version |
Resolved CLI version installed (no leading v) |
- Prefer
tokenin CI. Epinio login only accepts a password via--password, so user/password auth puts the secret on the process command line. Token auth writes settings and avoids that. trust-caapplies only to user/password login (epinio login --trust-ca). Token auth writessettings.yamldirectly and does not use that flag.- Token settings are written to a file and
EPINIO_SETTINGSis exported so the Epinio CLI finds them on Linux, macOS, and Windows.
uses: epinio/setup-epinio-action@v1Maintainers: after publishing a release tag such as v1.0.0, move v1 to that commit.