Welcome to the Drills
Read little, type a lot. This book teaches you OpenBao the way you need it at work: first in dev mode on your laptop, then as a highly available cluster with three pods in Kubernetes.
The Training Rules
- Type, don’t copy. Run every command yourself once.
- Compare with Expected. After every drill you will find what you should see. If it differs, that is where the real lesson is.
- Pass the checkpoint. Move on only when the check script shows nothing but ✔.
- Solve the challenge on your own. First the hint, then the solution.
- Lab values stay in the lab. Root token
root, unseal keys, passwords: never use them in production.
Structure of Each Training Day
| Section | Purpose |
|---|---|
| Briefing | The essentials in a few bullet points |
| Drills | Commands with expected output |
| Checkpoint | Check script: did everything work? |
| Challenge | A task without instructions |
| Enterprise Note | What is different in production |
The Training Plan
| Week | Day | Unit |
|---|---|---|
| 1 – Dev mode | 0 | Setting up the training ground |
| 1 | Dev server and KV v2 | |
| 2 | Tokens and policies | |
| 3 | userpass, AppRole, response wrapping | |
| 4 | Dynamic database secrets | |
| 2 – Tools & cluster | 5 | Transit and PKI |
| 6 | Identity, groups, audit | |
| 7 | kind cluster and TLS | |
| 8 | HA installation with Helm: 3 pods, Raft | |
| 9 | Init, unseal, Raft, failover | |
| 3 – Operations | 10 | Auto-unseal and seal migration |
| 11 | Connecting workloads: Kubernetes auth, ESO, Agent Injector | |
| 12 | Audit, metrics, snapshots, upgrades | |
| 13 | Root token, rekey, rotation, namespaces, config as code | |
| 14 | Competition: disaster drills | |
| – | Final exam (Appendix B) | |
| – | HSM via PKCS#11, optional (Appendix C) |
The Training Ground
Week 1: laptop Weeks 2–3: kind cluster "bao-lab"
┌──────────────────────┐ ┌──────────────────────────────────────┐
│ bao server -dev │ │ ns openbao: openbao-0 (active) │
│ 127.0.0.1:8200 │ ───────► │ openbao-1 (standby) │
│ Token: root │ │ openbao-2 (standby) │
│ docker: bao-pg │ │ Raft · TLS · Auto-Unseal│
└──────────────────────┘ │ ns unsealer: bao-unsealer (Transit) │
│ ns webshop: App + ESO / Injector │
└──────────────────────────────────────┘
Tip: Tested with OpenBao 2.7.1. If a flag differs:
bao <befehl> -hand the docs at openbao.org.
Let’s go.
Thomas Zachmann, October 2026