BKR-JOB-MODIFY(1)

📦
version 29.2 · 3 versions
, in epel 9

💅 bkr-job-modify(1) — the Beaker manual, bestie edition

okay so this is bkr-job-modify, straight out of the Beaker manual set, and it's literally the glow-up tool for your jobs ✨

✨ NAME ✨

bkr-job-modify — Modify Beaker jobs 🛠️

🌸 SYNOPSIS 🌸

bkr job-modify [options] <taskspec>
  [--response <response>] [--retention-tag <retention_tag>]
  [--product <product>] [--priority <priority>]

🦋 DESCRIPTION 🦋

You pass in one or more <taskspec> arguments and those babies get modified. That's it, that's the whole vibe 💖

The <taskspec> arguments use the exact same format as every other bkr subcommand (think J:1234). Wanna know the full tea on taskspecs? Go read Specifying tasks in bkr(1). iykyk 📖

🎀 OPTIONS 🎀

  • --response <response> — sets the response type of the job. it's giving two choices only: 'ack' or 'nak'. pick your fighter 💅
  • --retention-tag <retention_tag> — sets the retention tag of a job. heads up bestie, it must coincide with the correct product value. peek at the job page to see the list of available retention tags 👀
  • --product <product> — sets the product of a job. and yeah, this one must co-incide with the correct retention tag value (they're a package deal fr fr). the job page has the full list of available products 🌈
  • --priority <priority> — sets the priority. recipe sets with higher priority get scheduled sooner by Beaker's scheduler 🔥. only permitted for recipe sets and jobs that are queued, no cutting the line otherwise 🙈. valid priorities are: Low, Medium, Normal, High, Urgent 👑
  • --whiteboard <whiteboard> — sets the whiteboard of a job or recipe. the whiteboard is a free-form string you use to describe the job or recipe — go off, write whatever 🖊️

The common bkr options are described in the Options section of bkr(1). don't forget to check it 🫶

⭐ EXIT STATUS ⭐

Non-zero on error, otherwise zero. simple as that 💀

🔥 EXAMPLES 🔥

Set a recipe set to 'ack':

bkr job-modify RS:1 --response ack

Set multiple jobs to be 'nak':

bkr job-modify J:1 J:2 --response nak

Set a job's retention tag of 60days:

bkr job-modify J:1 --retention-tag 60days

Set a job's product to validproduct and the audit retention tag:

bkr job-modify J:1 --product validproduct --retention-tag audit

Unset a job's product and change to the scratch retention tag:

bkr job-modify J:1 --retention-tag scratch --product=

Set a job's priority to 'High' which will apply to all the recipe sets in the job:

bkr job-modify J:1 --priority High

Set a recipe set's priority to 'High':

bkr job-modify RS:1 --priority High

🧚 SEE ALSO 🧚

💜 AUTHOR 💜

The Beaker team <beaker-devel@lists.fedorahosted.org> — iconic behavior, honestly 🫶

2013-2025 Red Hat, Inc.

and that's the whole page, bestie — no cap, every flag accounted for 🎀

this was version 29.2, dated May 26, 2025, and yes the manual name is BKR-JOB-MODIFY(1) in case you forgot already 😭 slay, go modify some jobs 💅✨

📦 where this page comes from