Skip to main content

approve

approve a build waiting for approval, so it deploys

✅ Approve a build waiting for approval, so it deploys.

A deployment whose deploy policy is "Require approval" stops each finished build at awaiting_approval until a project admin or owner approves it. Approving deploys it now; the running version keeps serving until the new one is ready. The approval is recorded in the audit log.

You can't approve a build you requested yourself unless you're the only member of the account; another project admin has to. A build waits up to 7 days, then expires. A newer build for the same deployment replaces a waiting one.

It asks for confirmation first; --yes skips the question. Without a terminal (CI, a pipe, --no-input) it refuses to run unless --yes is given.

Usage​

csph deployments builds approve <build-id> [flags]

Options​

Command Specific​

--account <string>
account ID
--deployment <string>
deployment ID (required)

-y, --yes

skip the confirmation prompt

Formatting​

For more information about formatting options, see Formatting.

-o, --output <string>

output format: [table|plain|csv|json|yaml]

Available Fields​

approved_at, approved_by, awaiting_approval_at, build_duration_seconds, built_at, cache_hit_ratio, canceled_at, commit_author, commit_message, commit_sha, created_at, declared_build_args, deployed_by, deployment_id, duration_seconds, environment_id, failure_message, failure_reason, finished_at, git_ref, id, image_digest, image_signature, image_size_bytes, manifest, mode, object, pipeline_tier, pre_deploy_command, promoted_from, reject_reason, rejected_at, rejected_by, service_id, source_kind, source_ref, started_at, status, trigger_source

Inherited​

--config <string>
config file (default is $HOME/.config/computesphere/configuration.yaml)
--debug
enable debug logging

-h, --help

show this help message

-i, --interactive

run interactively (prompts, pickers, table browser)
--log-level <string>
log level: [trace|debug|info|warn|error|fatal|panic|disabled||api]
--no-color
disable color output
--no-input
disable interactive mode

Examples​

# approve a waiting build (asks first)
> csph deployment builds approve <build-id> --deployment <deployment-id>

# approve without asking, e.g. in a release script
> csph deployment builds approve <build-id> --deployment <deployment-id> --yes

# find the builds waiting for approval
> csph deployment builds list <deployment-id> --status awaiting_approval

See also​