vllnt-deploy-action

GitHub Action that POSTs build results to the vllnt-platform deployer. Used in vllnt org repos' .github/workflows/build.yml (see ../workflow-template/build.yml).

Setup

Operator pushes this directory's contents to github.com/vllnt/deploy-action (a new repo). Then references via:

- uses: vllnt/deploy-action@v1
  with:
    service: bntvllnt
    env:     production
    sha:     ${{ github.sha }}
    digest:  ${{ steps.build.outputs.digest }}
  env:
    DEPLOYER_API_BEARER: ${{ secrets.DEPLOYER_API_BEARER }}

Required secret

DEPLOYER_API_BEARER — bearer token matching the deployer's -api-bearer flag. Set as repo OR org Actions secret. Org secret recommended so new repos inherit without per-repo setup.

Versioning

Tag releases as v1, v1.0.0, v1.1.0, etc. Workflows pin to @v1 (major version, automatic minor/patch).

To cut a release:

git tag v1.0.0
git push --tags
git tag -d v1 && git tag v1 && git push --tags --force  # move v1 alias

Behavior

1. Validates inputs (env, sha, digest format, pr_number if preview).
2. POSTs to <deployer_url>/api/v1/service/<service>/deploy.
3. Retries 3× with backoff on non-2xx.
4. Sets outputs url + duration_ms.
5. Writes a step summary to the GitHub Action run UI.

Failure modes surface as ::error:: annotations on the Check Run.

Audit trail

Each invocation publishes a builds.started + builds.done event via the deployer's queue.Publisher (stdout → Loki today; NATS JetStream when wired). Optional agent_id input attributes the build to a specific agent for dashboard breakdown.