openqa-dump-templates(1)

✨ openqa-dump-templates(1) ✨

okay bestie, so this is a page from the openQA Documentation and it's literally called openQA dump-templates β€” yes, the command is openqa-dump-templates, and no, it's not as scary as it sounds, i promise 🫢


πŸ’… NAME πŸ’…

openqa-dump-templates β€” dump openQA templates, periodt.


🌸 SYNOPSIS 🌸

openqa-dump-templates [OPTIONS] [TABLES...]

like, options first, then whichever tables you're feeling today ✨


πŸŽ€ OPTIONS πŸŽ€

  • --host HOST β€” connect to the host you specify. if you don't say anything, it just defaults to localhost (home sweet home 🏠).
  • --apibase β€” set the API base URL component. the default is /api/v1, no notes πŸ’…
  • --apikey KEY, --apisecret SECRET β€” give it your api key and secret to use. this overrides using the config file ~/.config/openqa/client.conf and the environment variable "OPENQA_API_KEY". ⚠️ but listen β€” using this is discouraged because there's a risk of leaking your credentials. so like, be careful, bestie, fr.
  • --group GROUP β€” dump only the job group you name, nothing else πŸ‘‘
  • --test NAME β€” dump only the testsuite with that name.
  • --machine NAME β€” dump only the machine with that name.
  • --product NAME β€” dump only the product with that name.
  • --full β€” when you're dumping a specific job group, this also dumps the related test suites, products and machines. it's giving "the whole friend group showed up" 😭
  • --json β€” dump as json.
  • --convert β€” convert legacy non-YAML job groups to modern YAML.

dump as json

  • --help, -h β€” print help. classic.

πŸ¦‹ TABLES πŸ¦‹

these are the tables you can name on the command line, iconic lineup tbh:

  • Machines
  • TestSuites
  • Products
  • JobTemplates
  • JobGroups

🌈 SYNOPSIS 🌈

(again, but make it examples πŸ’–)

openqa-dump-templates --host openqa.example.com Products
openqa-dump-templates --host openqa.example.com --group "openSUSE
Tumbleweed" --full
openqa-dump-templates --host openqa.example.com --test "gnome"
openqa-dump-templates --host openqa.example.com --machine "64bit"

look at that second one wrapping onto two lines β€” that group name "openSUSE Tumbleweed" is long and it's thriving πŸ’…


πŸ’œ DESCRIPTION πŸ’œ

dump openQA database tables for Machines, TestSuites, Products, JobTemplates β€” for example so you can load them onto another instance. it's basically packing a lil suitcase for your data and moving it somewhere new 🧳✨


ngl, every flag, table name, default value, path and example above is exactly as it appears in the original β€” i did not touch a single character of the literal stuff, i just gave it a wardrobe change πŸ’…

okay that's the whole page, you ate it, go dump some templates πŸ“

this beauty is from perl v5.42.3, dated 2026-09-10, and it's the openqa-dump-templates(1) manual β€” mwah, bye bestie πŸŽ€πŸ’–

πŸ“¦ where this page comes from