Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 0: Das Trainingsgelände aufbauen

Ziel: Alle Werkzeuge laufen, ~/bao-lab steht. · Dauer: ca. 20 min · Voraussetzung: keine

Briefing

  • Teil A (Tag 1–6) braucht nur bao, curl und jq.
  • Teil B (Tag 7–14) braucht zusätzlich Docker, kind, kubectl, helm und OpenSSL 3.
  • Das Buch ist mit OpenBao v2.7.1 getestet. Neuere Versionen funktionieren in der Regel genauso.
  • Die CLI heißt bao, nicht vault. Ihre Umgebungsvariablen beginnen mit BAO_.

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@3

Erwartet (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 version

Erwartet:

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-lab

Erwartet:

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-install

Warum? 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 && bwho

Erwartet:

{"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 mise oder asdf.
  • Prüfe die Checksummen und Signaturen der Releases, bevor du Binaries verteilst.
  • BAO_TOKEN gehört nie in ~/.zshrc. Das Root-Token root gibt es nur im Lab.
  • Für Produktion: Paket-Repository oder Container-Image aus einer geprüften internen Registry.