Skip to main content

list

list a deployment's builds

🏗️ List a deployment's builds, newest first.

Each row shows the build's id, status, what triggered it (git_push, cli, api, manual, promote, rollback, template), the short commit SHA, when it was created, and how long it took ("-" while it is still running).

Usage​

csph deployments builds list <deployment-id> [flags]

Aliases​

deployments builds list, deployments builds ls, deployments build list, deployments build ls, deployment builds list, deployment builds ls, deployment build list, deployment build ls, deploys builds list, deploys builds ls, deploys build list, deploys build ls

Options​

Command Specific​

--account <string>
account ID

-p, --page <int> (default 1)

page number

-s, --size <int> (default 0)

max items to return (0 = all / server default)
--status <string>
only builds with this status: [pending|dispatched|building|built|awaiting_approval|predeploying|deploying|succeeded|failed|canceling|canceled]

Formatting​

For more information about formatting options, see Formatting.

--fields <strings>
output JSON with the specified fields
--jq <string>
filter JSON output with jq expression

-o, --output <string>

output format: [table|plain|csv|json|yaml]
--template <string>
format JSON using a Go template

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​

# list a deployment's builds
> csph deployment builds list <deployment-id>

# only the failed ones
> csph deployment builds list <deployment-id> --status failed

# the 5 most recent, as JSON
> csph deployment builds list <deployment-id> --size 5 --output json

# just the ids and statuses
> csph deployment builds list <deployment-id> -o json --fields id,status

# pick a deployment interactively
> csph deployment builds list -i

See also​