OpenVox Training › Class 2 of 3
OpenVox Journeyman
For the people who will write and own the estate: modules, tests, Hiera 5 data, roles and profiles, the control repo, r10k, OnceOver and Beaker.
$2,500 per student
4 days · max 10 · minimum 5. Private corporate class $16,500 per class week. Price list.
Overview
Journeyman takes students from writing a class to shipping code a team can maintain: a tested, Forge-shaped module, Hiera 5 data, a role built from profiles, an r10k-deployed control repo, and OpenBolt for the work that has to happen right now. It finishes with a heritage-code cleanup clinic. Lab time is 40–50% of the clock.
At a glance
Scheduling: a regional public class needs a minimum of 5 students. A private corporate class is for a single company, also with a minimum of 5, and the customer covers instructor travel. Class dates and the current range: ask us.
Price: regional public class $2,500 per student, minimum 5 students to run a class. Private corporate class for a single company: $16,500 per class week, minimum 5 students, and the customer covers instructor travel. Price list.
Who should attend
- The people who will own modules, data and the control repo
- OpenVox User graduates moving into module development
- Teams cleaning up legacy Puppet code ahead of OpenVox 8
What you will be able to do
- Build a Forge-shaped module (layout,
metadata.json, README, examples) - Scaffold and unit test with a devkit
- Write rspec-puppet tests, treating warnings as failures
- Lint with
puppet-lint - Design Hiera 5:
hiera.yamlv5,lookup(), automatic parameter lookup, merge strategies - Implement roles and profiles correctly
- Stand up a control repo, Puppetfile and r10k, with environments as Git branches
- Use OpenBolt for the work that has to happen now: projects, inventory (targets, groups, SSH and WinRM), commands, tasks and plans
- Write OpenBolt tasks and plans in a module, including
applyblocks, and use OpenBolt with r10k and in CI - Use and write OpenBolt plugins, including a small inventory plugin
- Connect OpenBolt to OpenVoxDB and target nodes by their facts with PQL
- Refactor heritage code: legacy facts,
hiera(), node-regex sprawl - Explain environments (code) versus tiers (data)
Course outline
Day 1 — Development tooling as a day job
The OpenVox DevKit and bundle exec; scaffolding modules with Jig; lint, syntax and metadata checks; rspec-puppet unit tests; a custom fact.
Day 2 — Control repo and r10k
The control repository; Puppetfile and r10k deploys; feature-branch environments; pinning modules; environments (code) vs tiers (data); OnceOver compile tests for the control repo.
Day 3 — Data, roles, a console, and OpenBolt
Hiera 5 and lookup(); merge strategies; roles and profiles; openvox-gui (with Foreman compared); OpenBolt fundamentals: commands, tasks and plans, inventory with targets and groups, SSH and WinRM transports.
Day 4 — OpenBolt at work, then prove it
OpenBolt tasks and plans in a module, apply blocks, r10k and CI; OpenBolt plugins and writing a small one; connecting OpenBolt to OpenVoxDB to target nodes by fact; Beaker and fleet tooling overview; heritage-cleanup review; practical exam (90 minutes, Git repo) plus oral.
Hands-on labs
Every concept is followed by time at the keyboard on a real lab estate.
- Ruby and voxpupuli-test on a clone
- Scaffold a new module with Jig
- Lint and lint fix
- Write the spec you wish existed
- Custom fact and spec
- Control repo from the official template
- r10k install and first deploy
- Feature branch isolation
- OnceOver smoke test
- Puppetfile pinning
hiera.yamland--explain- Merge: unique vs a broken deep merge
- A role and two profiles
- openvox-gui
- OpenBolt project, inventory and first runs
- An OpenBolt task and plan, with an apply block
- Write a small OpenBolt inventory plugin
- Target nodes by fact from OpenVoxDB
- Heritage cleanup pull request (pairs, as homework)
- Beaker idempotency and VoxBox lint (optional)
- Practical exam (90 minutes, submitted as a Git repo)
What students get
- Journeyman Lecture Manual and Lab Manual
- A Git repo of your module and control-repo branch
- Facts and
lookup()cheat sheets - Reading list
- An OpenBolt project with your tasks, plan and inventory
- Certificate of completion for OpenVox Journeyman
Every student who completes the class receives a certificate of completion. A formal certification program is planned.
Next: OpenVox Architect, where you move from shipping a module to defending an estate.
OpenVox is built and maintained by the OpenVox community under Vox Pupuli. Product facts in this class follow the official OpenVox documentation. S & S Consulting Group designs and teaches the course.
Ask about OpenVox Journeyman
Tell us how many people, where they are today, and what you need them to own afterwards. We will tell you which class fits and what it takes to run it for your team.
info@ssconsultinggroup.net · 912-549-0272