Deploys an already-built image to a Levelrail app, waits for the rollout to converge, then reports back to GitHub: a deployment status (shown on the PR's Deployments panel) and a check run on the commit.
- uses: glincker/deploy-action@v1
with:
api-url: ${{ secrets.LEVELRAIL_API_URL }}
api-token: ${{ secrets.LEVELRAIL_API_TOKEN }}
app: my-app
image: ghcr.io/${{ github.repository }}:${{ github.sha }}The job needs permissions: { contents: read, deployments: write, checks: write }.
See example-workflow.yml for push, workflow_dispatch and repository_dispatch triggers.
| Input | Default | Meaning |
|---|---|---|
api-url, app, image |
required | Same as the plain deploy action |
api-token |
empty | Deploy token, or leave empty and set oidc: true |
oidc |
false |
Swap the job OIDC identity for a 15 minute, app-scoped token. Needs id-token: write and a CI trust on the app, so no long-lived secret is stored |
rollback-on-failure |
false |
Redeploy the previously running image when the deploy fails or times out |
confirm |
false |
Deploy into a protected environment |
wait |
true |
Wait for convergence; false reports the check as neutral |
timeout |
5m |
Rollout wait limit |
github-token |
github.token |
Posts the reports; empty turns reporting off |
environment-url |
empty | App URL shown on the GitHub deployment |
sha |
PR head or pushed commit | Commit the reports attach to |
Outputs: status (succeeded, failed, timeout, accepted) and report-warnings.
A failed report call never changes the deploy result: the deploy stays green, the failure is
printed as a workflow warning and counted in report-warnings.
Which GitHub environment name is used, and whether deployments or check runs are posted,
is set per app: Deploys page in the dashboard, or levelrail-cli apps github-actions set <app>.
This repository is a mirror of the actions kept in glincker/levelrail under integrations/github-action. File issues and pull requests there.