BKR-JOB-WATCH(1)

📦
version 29.2 · 3 versions
, in epel 9

💅 BKR-JOB-WATCH(1) — the Beaker girlie's guide

okay so real talk, this is a page from the Beaker manual set, and it's literally just about watching a job do its thing. let's get into it 🎀

✨ NAME ✨

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

🦋 SYNOPSIS 🦋

bkr job-watch [options] <taskspec>...

🌸 DESCRIPTION 🌸

so you pass in one or more <taskspec> arguments and the command just... watches them. like a hawk. every single state change gets reported straight to stdout, bestie. and the command will exit only when everything is finished — it does not get bored and it does not leave early, periodt. 💅

the <taskspec> arguments follow the exact same format as in other bkr subcommands (for example, J:1234). if you wanna know all the deets on that, go see "Specifying tasks" in bkr(1). iykyk.

💖 OPTIONS 💖

the common bkr options are all described in the Options section of bkr(1) — go peek there, she's got the full rundown ✨

🔥 EXIT STATUS 🔥

  • non-zero — something went wrong 😭 (error!)
  • zero — we're so back, everything's fine 🫶

💀 BUGS 💀

okay so listen. in its current implementation, this command polls the Beaker server periodically for state changes. and like, to avoid overloading the server (be nice to her!!), only the given <taskspec> arguments and none of their subcomponents are watched. ngl that's a little tragic. 🙈

this limitation will be addressed in an upcoming release — most likely by switching to a message bus. main character energy incoming 🚌✨

🌈 EXAMPLES 🌈

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

bkr job-watch J:12345
💀 and here's the sad part: due to the limitation noted above, this won't actually watch any recipes within the job — even though it should. the audacity, fr fr. 😭

👑 SEE ALSO 👑

🧚 AUTHOR 🧚

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

2013-2025 Red Hat, Inc.

k bye bestie, go watch those jobs slay ✨ — this iconic page is version 29.2, dated May 26, 2025, and that's the whole vibe check 💜

📦 where this page comes from