BKR-JOB-CANCEL(1)

📦
version 29.2 · 3 versions
, in epel 9

💅 BKR-JOB-CANCEL(1) — the Beaker girlie's guide to yeeting a running job

ok so this is a page from the Beaker manual, section 1, and it's literally about cancelling running Beaker jobs. bestie, if you've ever queued a job with the wrong distro and needed to ✨undo✨ it immediately, this is your moment. no cap.

🌸 NAME 🌸

bkr-job-cancel — cancel running Beaker jobs. that's it, that's the whole vibe. it stops jobs. it's giving "abort mission" energy. 💅

✨ SYNOPSIS ✨

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

ok so you give it one or more <taskspec> arguments and it cancels them. and yes, [options] goes in there too, more on that below. 🫶

🦋 DESCRIPTION 🦋

Specify one or more <taskspec> arguments to be cancelled. that's the whole assignment. drop the specs, hit enter, watch them go poof. 💀

The <taskspec> arguments follow the same format as in other bkr subcommands (for example, J:1234). See Specifying tasks in bkr(1). iykyk — if you've used any other bkr subcommand you already know the drill, it's the same language everywhere. 🎀

🚨 important vibe check: 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. lowkey that's fair — like, you can't cancel part of a recipe, she's a package deal, periodt. 😭

💖 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. 📝 literally so useful — future you (and your whole team) will see exactly why you nuked it, and they will be obsessed with your documentation game.

Common bkr options are described in the Options section of bkr(1). go peek at the main page for those, she's got the receipts. 🌈

🔥 EXIT STATUS 🔥

Non-zero on error, otherwise zero. so: zero = slay, non-zero = something went sideways, go read the error. 💀

⭐ EXAMPLES ⭐

Cancel job 1234 with a helpful message:

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

see how the --msg is right there being all helpful and polite? that's main character energy. do that. 👑

🧚 SEE ALSO 🧚

the mothership page. if you're confused about anything, she explains it. 🫶

🍓 AUTHOR 🍓

The Beaker team <beaker-devel@lists.fedorahosted.org> — absolute icons, we love them, no notes. 💜

2013-2025 Red Hat, Inc. all rights reserved, all vibes reserved. 🎀

🌸 ok bye bestie! this page came from Beaker version 29.2, dated May 26, 2025. go cancel some jobs responsibly, and remember: if it's a recipe or a task inside a recipe set, she stays. only jobs and recipe sets get the yeet treatment. 💅✨
📦 where this page comes from