bkr-job-watch man page

bkr-job-watch — Watch the progress of a Beaker job

Synopsis

bkr job-watch [options] <taskspec>…

Description

Specify one or more <taskspec> arguments to be watched. Each state change will be reported to stdout. The command will exit only when everything is finished.

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

Options

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

Exit Status

Non-zero on error, otherwise zero.

Bugs

In its current implementation this command polls the Beaker server periodically for state changes. To avoid overloading the server, only the given <taskspec> arguments and none of their subcomponents are watched. This limitation will be addressed in an upcoming release (most likely by switching to a message bus).

Examples

Watch the progress of job 12345 and all recipes within it:

bkr job-watch J:12345

Due to the limitation noted above, this won’t actually watch any recipes within the job, although it should.

See Also

bkr(1)

Author

The Beaker team <beaker-devel@lists.fedorahosted.org>

Referenced By

bkr(1), bkr-job-submit(1), bkr-update-inventory(1).

Oct 03, 2017 24.4 Beaker