bkr job-cancel: Cancel running Beaker jobs¶

Synopsis¶

bkr job-cancel [–msg <message>] [options] <taskspec>...

Description¶

Specify one or more <taskspec> arguments to be cancelled.

The <taskspec> arguments follow the same format as in other bkr subcommands (for example, J:1234). See Specifying tasks in bkr(1).

Only jobs and recipe sets may be cancelled. It does not make sense to cancel individual recipes within a recipe set, or tasks within a recipe, so Beaker does not permit this.

Options¶

--msg <message>¶: Optionally you can provide a message describing the reason for the cancellation. This message will be recorded against all outstanding tasks in the cancelled recipe set, and will be visible in the Beaker web UI.

Common bkr options are described in the Options section of bkr(1).

Exit status¶

Non-zero on error, otherwise zero.

Examples¶

Cancel job 1234 with a helpful message:

bkr job-cancel --msg "Selected wrong distro, resubmitting job" J:1234