Tag 0: Das Trainingsgelände
Ziel: Die Labor-VM anlegen, Docker, OpenTofu und k3s installieren, den Begleitcode holen und das Image von notes bauen. · Dauer: ca. 45 min · Voraussetzung: keine
Briefing
- Gearbeitet wird in der Ubuntu-24.04-VM
tf, als Userubuntuin~/tf-lab. Alles, was OpenTofu verwaltet, läuft auf dieser VM: Container in Docker, später Pods in k3s. - OpenTofu (
tofu) liest Konfiguration in HCL, vergleicht sie mit dem, was es schon angelegt hat (dem State), und schlägt die nötigen Änderungen vor. - Provider sind Plugins, die eine API ansprechen:
Docker, Kubernetes, Helm, Keycloak. OpenTofu lädt sie bei
tofu initaus der Registry. - notes ist die Anwendung, die in diesem Buch als Code entsteht: notes-api (Go) mit Postgres, später mit Login über Keycloak.
~/tf-lab/tagNN/*.tf ─► tofu plan/apply ─► Provider docker ─► Docker auf der VM
─► Provider kubernetes ─► k3s auf der VM
terraform.tfstate ◄┘ (was angelegt wurde)
Terraform: OpenTofu ist 2023 als Abspaltung von Terraform entstanden, als HashiCorp die Lizenz auf die BSL umstellte. OpenTofu steht unter der MPL 2.0 und gehört zur Linux Foundation. Konfiguration, Provider und State sind kompatibel; wo sich etwas unterscheidet, steht ein Kasten wie dieser. Statt
tofutippst du dannterraform.
Drill 1: Die Labor-VM
Auf dem Laptop (Multipass von
multipass.run):
multipass launch 24.04 --name tf --cpus 4 --memory 8G --disk 40G
multipass exec tf -- bash -c "echo '$(cat ~/.ssh/id_ed25519.pub)' \
>> ~/.ssh/authorized_keys"
multipass info tf | grep IPv4
ssh ubuntu@<IP aus der Ausgabe>
Ab hier läuft alles in der VM.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Docker
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
-o /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<'EOF'
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: noble
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt-get update -qq
sudo apt-get install -y -qq docker-ce docker-ce-cli containerd.io \
docker-compose-plugin jq git unzip >/dev/null
sudo usermod -aG docker ubuntu- Zuerst der Schlüssel, mit dem Docker seine Pakete signiert, dann die
Paketquelle.
nobleist der Codename von Ubuntu 24.04. usermod -aG dockererlaubt dem Benutzerubuntu, Docker ohnesudozu nutzen.
Melde dich ab (exit) und wieder an, damit die Gruppe
docker gilt:
docker --versionErwartet:
Docker version 29.9.2, build a82e528
Fortschritt speichern? Kostenlos registrieren
Drill 3: OpenTofu
OpenTofu gibt es als Paket für Debian und Ubuntu:
ARCH=$(dpkg --print-architecture)
cd /tmp
U=https://github.com/opentofu/opentofu/releases/download/v1.13.2
curl -fsSLO $U/tofu_1.13.2_${ARCH}.deb
sudo dpkg -i tofu_1.13.2_${ARCH}.deb >/dev/null
tofu versionErwartet:
OpenTofu v1.13.2
on linux_amd64
Ein einzelnes Programm, keine Laufzeitumgebung, keine Datenbank.
Alles Weitere lädt tofu init je Projekt nach.
Fortschritt speichern? Kostenlos registrieren
Drill 4: k3s
Ab Tag 6 verwaltet OpenTofu auch Kubernetes. k3s ist ein vollständiges Kubernetes in einem Programm:
curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=v1.36.5+k3s1 \
sh -s - --write-kubeconfig-mode 644 2>&1 | tail -1
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
sleep 20
kubectl get nodesErwartet:
[INFO] systemd: Starting k3s
NAME STATUS ROLES AGE VERSION
tf Ready control-plane 20s v1.36.5+k3s1
Steht dort noch NotReady, warte ein paar Sekunden und
frage noch einmal.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Begleitcode und notes
mkdir -p ~/tf-lab/setup
git clone -q https://github.com/thomaszachmann/opentofu-zum-anfassen.git ~/tf-lab/code
cp ~/tf-lab/code/setup/env.sh ~/tf-lab/setup/
echo 'source ~/tf-lab/setup/env.sh' >> ~/.bashrc
source ~/tf-lab/setup/env.sh
grep -v '^#' ~/tf-lab/setup/env.sh
cd ~/tf-lab/code/notes/notes-api
docker build -q --build-arg VERSION=0.4.0 -t notes-api:0.4.0 .
docker images notes-api:0.4.0Erwartet (IDs weichen ab):
export LAB="$HOME/tf-lab"
export VM_IP="${VM_IP:-$(hostname -I | awk '{print $1}')}" # erste IP der VM
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml # k3s (ab Tag 6)
export TF_PLUGIN_CACHE_DIR="$HOME/.terraform.d/plugin-cache" # Provider nur einmal laden
mkdir -p "$TF_PLUGIN_CACHE_DIR"
export NOTES_API_KEY="lab-api-key-123" # nur Labor
true
sha256:23990cbdfb04122f8111cb14466ef203c08e967f414763c0ecd258814083cbd7
IMAGE ID DISK USAGE CONTENT SIZE EXTRA
notes-api:0.4.0 23990cbdfb04 16.4MB 4.51MB
TF_PLUGIN_CACHE_DIR lässt OpenTofu jeden Provider nur
einmal herunterladen, auch wenn jeder Trainingstag ein eigenes
Verzeichnis hat. Ab jetzt lädt jede neue Shell env.sh von
selbst.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
tofu version | head -1Erwartet:
OpenTofu v1.13.2
kubectl get nodesErwartet: ein Knoten mit Status Ready.
NAME STATUS ROLES AGE VERSION
tf Ready control-plane 5m v1.36.5+k3s1
docker images notes-api:0.4.0Erwartet (die ID weicht ab):
IMAGE ID DISK USAGE CONTENT SIZE EXTRA
notes-api:0.4.0 23990cbdfb04 16.4MB 4.51MB
Challenge
tofu console ist eine interaktive Spielwiese für
Ausdrücke in HCL. Lass dir damit notes in Großbuchstaben
und die Länge der Liste ["db", "api", "proxy"]
ausgeben.
Hinweis: Die Funktionen heißen upper
und length. Die Konsole liest auch von stdin.
Lösung
cd /tmp
echo 'upper("notes")' | tofu console
echo 'length(["db", "api", "proxy"])' | tofu consoleErwartet:
"NOTES"
3
Die Konsole kennt alle eingebauten Funktionen. In einem Projektordner sieht sie auch Variablen und Ressourcen – an Tag 2 nutzt du das.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Versionen festnageln: Im Team läuft überall
dieselbe OpenTofu-Version. Werkzeuge wie
tenvoder ein Container-Image für die CI sorgen dafür. - Ein Labor, viele Ziele: Hier zeigt alles auf eine VM. In der Praxis spricht dieselbe Konfiguration mit Cloud-APIs, VMware, Proxmox oder einem Kubernetes-Cluster – die Arbeitsweise bleibt gleich.
- Lizenz prüfen: Wer Terraform in einem eigenen Produkt anbietet, sollte die BSL lesen. Für die eigene Infrastruktur sind beide frei nutzbar.