BKR-MACHINE-TEST(1)

📦
version 29.2 · 3 versions
, in epel 9

💅 bkr-machine-test — like, the Beaker job generator for testing a system 🎀

okay bestie, welcome to BKR-MACHINE-TEST(1) from the Beaker manual set — yes this is the whole vibe, let's get into it ✨

🌸 NAME

bkr-machine-test — generate a Beaker job to test a system. that's it, that's the whole job description 🫶

✨ SYNOPSIS

bkr machine-test --machine <fqdn> [--inventory] [workflow options]
[options]

no cap, that's the shape of it — --machine <fqdn> is the main character here 👑

🦋 DESCRIPTION

So basically: this command generates a Beaker job to test the system identified by <fqdn>. you point it at a machine, it hands you back a job. iconic behavior, honestly 💅

🎀 OPTIONS

  • --inventory — include the /distribution/inventory task in the generated job 🧚 this is literally so the system's details get updated in Beaker. slay.

also, quick heads up bestie: the common workflow options are described in the Workflow options section of bkr(1), and the common bkr options live in the Options section of bkr(1). iykyk 📖

💀 EXIT STATUS

Non-zero on error, otherwise zero. fr fr, that's the whole thing — zero means we ate, non-zero means something went sideways 😭

🔥 EXAMPLES

okay so here's where it gets good. 🍓

1. Test a particular system on RHEL5 and RHEL6, including running the inventory task:

bkr machine-test --machine=system1.example.invalid --inventory \
        --family RedHatEnterpriseLinuxServer5 \
        --family RedHatEnterpriseLinux6

look at those --family flags stacking up, we love a multi-distro moment 🌈

2. Attempt to run the inventory task on faultysystem.example.invalid even though it is marked as Broken:

bkr machine-test --ignore-system-status --inventory \
         --machine=faultysystem.example.invalid
⚠️ note the wording there — it attempts to run the inventory task even though the system is marked Broken. --ignore-system-status is doing a lot of heavy lifting in that sentence, so like… know what you're doing 🙈

👑 SEE ALSO

bkr(1) — go read it, bestie, it's got the workflow options and the common options you're gonna need 💖

🌟 AUTHOR

The Beaker team <beaker-devel@lists.fedorahosted.org> — genuine legends, no notes 🫶

2013-2025 Red Hat, Inc. — periodt.

and that's a wrap, bestie! this page is from version 29.2, dated May 26, 2025 — so it's giving fresh-off-the-press energy ⭐ go test a machine, you're gonna eat 💅🎀

📦 where this page comes from