Skip to main content

runs

start and manage runs

⏱️ Start and manage runs.

A run is one execution of a command in a service's image. A scheduled job's schedule starts runs of its command; start starts one on demand, either the job's own command or a command you give after -- (a task run, such as a database migration).

A run is running, then succeeded or failed. A failed run says why: the command's exit code, or what stopped it from starting or finishing. cancel stops a run that is still going.

Subcommands​

CommandDescription
listlist a scheduled job's runs
startstart a run now
logsread what a run wrote
cancelcancel a run that is still going

See also​