Tag 0: Das Trainingsgelände aufbauen
Ziel: Alle Werkzeuge laufen,
~/bao-labsteht. · Dauer: ca. 20 min · Voraussetzung: keine
Briefing
- Teil A (Tag 1–6) braucht nur
bao,curlundjq. - Teil B (Tag 7–14) braucht zusätzlich Docker,
kind,kubectl,helmund OpenSSL 3. - Das Buch ist mit OpenBao v2.7.1 getestet. Neuere Versionen funktionieren in der Regel genauso.
- Die CLI heißt
bao, nichtvault. Ihre Umgebungsvariablen beginnen mitBAO_.
Drill 1: Werkzeuge installieren
macOS mit Homebrew:
brew install openbao kind kubectl helm jq openssl@3
OSSL=$(brew --prefix openssl@3)/bin
echo "export PATH=\"$OSSL:\$PATH\"" >> ~/.zshrc # vor /usr/bin/openssl
export PATH="$OSSL:$PATH"
brew list --versions openbao kind kubernetes-cli helm jq openssl@3Erwartet (Versionen können abweichen):
helm 4.1.1
jq 1.8.2
kind 0.32.0
kubernetes-cli 1.36.3
openbao 2.7.1
openssl@3 3.6.4
Warum openssl@3? macOS liefert unter
/usr/bin/openssl LibreSSL. Das kennt Optionen aus Tag 7 und
Tag 14 nicht. Homebrew legt openssl@3 nicht in den PATH,
daher der Eintrag in ~/.zshrc.
Linux: Lade bao als .deb, .rpm
oder Binary vom offiziellen Release v2.7.1 unter
https://github.com/openbao/openbao/releases/tag/v2.7.1.
kind, kubectl und helm bekommst
du über die jeweiligen offiziellen Release-Seiten, jq und
openssl über den Paketmanager deiner Distribution. Tag 14,
Szenario 7 braucht OpenSSL 3.4 oder neuer.
Achtung: Homebrew installiert immer die aktuelle Version. Wenn eine Ausgabe im Buch abweicht, prüfe zuerst
bao version.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Versionen prüfen
bao version
kind version
kubectl version --client
helm version --short
jq --version
openssl versionErwartet:
OpenBao v2.7.1 (a5db72ce...), committed 2026-10-01T15:32:54Z
kind v0.32.0 go1.26.3 darwin/arm64
Client Version: v1.36.3
Kustomize Version: v5.8.1
v4.1.1+g5caf004
jq-1.8.2
OpenSSL 3.6.4 25 Aug 2026 (Library: OpenSSL 3.6.4 25 Aug 2026)
Steht bei openssl version LibreSSL, fehlt
der PATH-Eintrag aus Drill 1.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Docker-Check
docker version --format '{{.Client.Version}} / {{.Server.Version}}'
docker info >/dev/null 2>&1 && echo "Docker läuft" || echo "Docker-Daemon fehlt"Erwartet (kann je nach Version abweichen):
29.2.1 / 29.2.1
Docker läuft
Falls Cannot connect to the Docker daemon erscheint,
starte Docker Desktop oder Colima. Für Teil A ist Docker erst an Tag 4
nötig.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Arbeitsverzeichnis anlegen
mkdir -p ~/bao-lab/{tag01,tag02,tag03,tag04,tag05,tag06,tls,k8s}
ls ~/bao-labErwartet:
k8s
tag01
tag02
...
tls
Fortschritt speichern? Kostenlos registrieren
Drill 5: Shell-Helfer
Hänge die Helfer an ~/.zshrc oder ~/.bashrc
an:
cat >> ~/.zshrc <<'EOF'
# --- OpenBao-Lab ---
alias bdev='bao server -dev -dev-root-token-id=root'
labenv() { export BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=root; }
alias bwho='bao token lookup -format=json | jq -c ".data | {display_name, policies, ttl}"'
EOF
source ~/.zshrc
bao -autocomplete-installWarum? bdev startet den Dev-Server mit festem Root-Token
root (nur Lab!). labenv setzt die Umgebung in
jedem neuen Terminal. Mit bwho siehst du sofort, als wer du
unterwegs bist.
Teste die Helfer: Starte im ersten Terminal den Server mit
bdev. Dann im zweiten Terminal:
labenv && bwhoErwartet:
{"display_name":"token","policies":["root"],"ttl":0}
Beende den Server danach mit Ctrl+C.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
for t in bao kind kubectl helm jq curl docker; do
command -v "$t" >/dev/null && echo "✔ $t" || echo "✘ $t fehlt"
done
[ -d ~/bao-lab/k8s ] && echo "✔ ~/bao-lab" || echo "✘ ~/bao-lab fehlt"
docker info >/dev/null 2>&1 && echo "✔ Docker-Daemon" || echo "✘ Docker-Daemon"
openssl version | grep -q '^OpenSSL 3' && echo "✔ OpenSSL 3" || echo "✘ OpenSSL 3"
type labenv >/dev/null 2>&1 && echo "✔ labenv" || echo "✘ labenv"Challenge
Schreib eine Shell-Funktion baoup. Sie soll den
Dev-Server im Hintergrund starten, das Log nach
~/bao-lab/dev.log schreiben und warten, bis
bao status erfolgreich ist.
Hinweis: bao status liefert den
Exit-Code 0, wenn der Server erreichbar und entsiegelt ist.
Lösung
baoup() {
bao server -dev -dev-root-token-id=root > ~/bao-lab/dev.log 2>&1 &
export BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=root
until bao status >/dev/null 2>&1; do sleep 0.5; done
echo "OpenBao bereit (PID $!)"
}Beenden: kill %1 oder
pkill -f "bao server -dev".
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Pinne die Versionen von CLI und Server im Team, zum Beispiel mit
miseoderasdf. - Prüfe die Checksummen und Signaturen der Releases, bevor du Binaries verteilst.
BAO_TOKENgehört nie in~/.zshrc. Das Root-Tokenrootgibt es nur im Lab.- Für Produktion: Paket-Repository oder Container-Image aus einer geprüften internen Registry.