Browse documentation

Configure Job build inputs

Declare non-secret Containerfile build arguments and verify a Run's inputs.

Containerfile Jobs can declare non-secret build arguments. Declare required inputs before running, and inspect the resulting Run rather than assuming later Job edits change historical builds. Build arguments and their output are not a safe place for credentials.

Declare and supply inputs

rp job args add <job-number> FLOG_VERSION
rp job args add <job-number> RELEASE_CHANNEL --default stable
rp job run <job-number> --source <full-sha> --build-arg FLOG_VERSION=1.2.3 --attach
rp job runs <job-number>

The first declaration is required on each manual Run; the second has a default. Use rp job args update to change one existing declaration and rp job args remove to remove one. No --default means required, bare --default means an empty default, and --default=VALUE handles values beginning with a dash. Automatic-trigger Jobs cannot declare a required argument because a triggered Run has no manual override; disable the trigger or supply a string default first.

Each Run snapshots its effective argument values and exact source commit. Repopack supplies the full SOURCE_SHA separately; do not declare that reserved name as a custom input. Build with a Job covers inspecting a Run and its artifacts. A successful Run remains project-only until a deliberate Release publication. For the other Job commands, see the Job CLI reference.