Zum Inhalt springen
Trainingslager IT-Trainingslager

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 User ubuntu in ~/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 init aus 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 tofu tippst du dann terraform.

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. noble ist der Codename von Ubuntu 24.04.
  • usermod -aG docker erlaubt dem Benutzer ubuntu, Docker ohne sudo zu nutzen.

Melde dich ab (exit) und wieder an, damit die Gruppe docker gilt:

docker --version

Erwartet:

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 version

Erwartet:

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 nodes

Erwartet:

[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.0

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

Erwartet:

OpenTofu v1.13.2
kubectl get nodes

Erwartet: 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.0

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

Erwartet:

"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 tenv oder 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.