Skip to main content

list

list a scheduled job's runs

⏱️ List a scheduled job's runs, newest first.

Each row shows the run's id, its status (running, succeeded or failed), what started it (schedule or manual), when it started, how long it took ("-" while it is still running), the command's exit code, and for a failed run why it failed.

Usage​

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

Aliases​

deployments runs list, deployments runs ls, deployments run list, deployments run ls, deployment runs list, deployment runs ls, deployment run list, deployment run ls, deploys runs list, deploys runs ls, deploys run list, deploys run ls

Options​

Command Specific​

--account <string>
account ID

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

max items to return (0 = all / server default)
--status <string>
only runs with this status: [running|success|failed]

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​

command, deployment_id, duration_ms, exit_code, finished_at, id, job_name, line_count, message, object, started_at, status, triggered_by

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 scheduled job's runs
> csph deployment runs list <deployment-id>

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

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

# why did the last failed run fail?
> csph deployment runs list <deployment-id> --status failed --size 1 -o json --jq '.[0].message'

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

See also​