Skip to content
Get Started

barca queue

A barca server’s run queue: the runs executing and the runs waiting to start, in order. It needs a server (--server URL, BARCA_SERVER or [server] url); without one it exits 2. Experimental.

barca queue [pause|resume] [--server [URL]] [--json]
barca queue --server # running and queued runs (a table in a terminal)
barca queue --server --json # {paused, paused_at, draining, max_runs, running, queued}
barca queue pause --server # queued runs wait; runs in flight go on; kept across restarts
barca queue resume --server # queued runs start again, in order

A run started with --queue last (barca get, barca run) has "queue": "last" in --json and queued last at the end of its row; every other run has "queue": null.

pause and resume answer with the queue after the change, and exit 2 on a --read-only server. See Operating barca serve: The run queue.


All commands · Output format · Errors and exit codes