Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 1: Erste Ressourcen mit dem Docker-Provider

Ziel: Eine erste Konfiguration schreiben, mit init, plan, apply und destroy den Lebenszyklus durchlaufen und lesen lernen, was OpenTofu vorhat – vor allem, wann es etwas ersetzt statt ändert. · Dauer: ca. 60 min · Voraussetzung: Tag 0

Briefing

  • Eine Konfiguration besteht aus .tf-Dateien in einem Verzeichnis. Darin stehen Blöcke: terraform (Versionen), provider (Verbindung), resource (was es geben soll).
  • tofu init lädt die Provider und schreibt ihre genauen Versionen in die Lock-Datei .terraform.lock.hcl.
  • tofu plan vergleicht Soll und Ist und zeigt die Änderungen: + anlegen, ~ ändern, -/+ ersetzen, - löschen. tofu apply führt sie aus.
  • Manche Eigenschaften lassen sich nicht ändern, nur neu anlegen. Bei einem Container sind das fast alle – der Plan sagt es mit # forces replacement.
 main.tf ─► tofu init  ─► .terraform/ + .terraform.lock.hcl
         ─► tofu plan  ─► „1 to add, 0 to change, 0 to destroy"
         ─► tofu apply ─► Docker: Netz, Image, Container  ─► terraform.tfstate

Drill 1: Die erste Konfiguration

mkdir -p ~/tf-lab/tag01 && cd ~/tf-lab/tag01
cat > main.tf <<'EOF'
terraform {
  required_version = ">= 1.13.0"
  required_providers {
    docker = {
      source  = "kreuzwerker/docker"
      version = "~> 4.6"
    }
  }
}

provider "docker" {}

resource "docker_network" "notes" {
  name = "notes-tag01"
}

resource "docker_image" "postgres" {
  name         = "postgres:18.6-alpine"
  keep_locally = true
}

resource "docker_container" "db" {
  name  = "notes-db-tag01"
  image = docker_image.postgres.image_id
  env = [
    "POSTGRES_USER=notes",
    "POSTGRES_PASSWORD=lab-db-pw-123",
    "POSTGRES_DB=notes",
  ]
  networks_advanced {
    name = docker_network.notes.name
  }
}
EOF
tofu init -no-color | grep -E 'Installing|Installed|initialized'
ls -A
grep -A2 'provider "registry.opentofu.org/kreuzwerker/docker"' .terraform.lock.hcl

Erwartet:

- Installing kreuzwerker/docker v4.6.0...
- Installed kreuzwerker/docker v4.6.0 (signed, key ID 0DCE698927DAF8EC)
OpenTofu has been successfully initialized!
.terraform
.terraform.lock.hcl
main.tf
provider "registry.opentofu.org/kreuzwerker/docker" {
  version     = "4.6.0"
  constraints = "~> 4.6"
  • ~> 4.6 erlaubt 4.6, 4.7 … aber nicht 5.0. Welche Version es tatsächlich wurde, hält die Lock-Datei fest – sie gehört ins Git, damit alle dieselbe benutzen.
  • docker_image.postgres.image_id ist eine Referenz: Der Container braucht das Image, also legt OpenTofu es zuerst an.
  • provider "docker" {} ohne Einstellungen nimmt den lokalen Docker-Socket.

Terraform: Terraform lädt Provider aus registry.terraform.io, OpenTofu aus registry.opentofu.org. Die Adressen in der Lock-Datei unterscheiden sich, die Provider selbst sind dieselben.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Der Plan

tofu plan -no-color | grep -E '^  [#+~-]|Plan:'

Erwartet:

  + create
  # docker_container.db will be created
  + resource "docker_container" "db" {
  # docker_image.postgres will be created
  + resource "docker_image" "postgres" {
  # docker_network.notes will be created
  + resource "docker_network" "notes" {
Plan: 3 to add, 0 to change, 0 to destroy.

Der vollständige Plan zeigt jedes Attribut. Viele stehen auf (known after apply): die ID des Containers, seine IP – Werte, die erst Docker vergibt. Der Plan ändert nichts. Er ist das Wichtigste, was OpenTofu dir sagt: Lies ihn jedes Mal.

Fortschritt speichern? Kostenlos registrieren

Drill 3: apply

tofu apply -auto-approve -no-color | grep -E 'Creation complete|Apply complete'
docker ps --filter name=notes-db-tag01
tofu state list

Erwartet (IDs und Zeiten weichen ab):

docker_network.notes: Creation complete after 0s [id=4c1f…]
docker_image.postgres: Creation complete after 0s [id=sha256:10a5c69a8303…]
docker_container.db: Creation complete after 1s [id=9b2e…]
Apply complete! Resources: 3 added, 0 changed, 0 destroyed.
CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS  ...
9b2e0c1d4a5f   10a5c69a8303   "docker-entrypoint.s…"   2 seconds ago   Up 1 second ...
docker_container.db
docker_image.postgres
docker_network.notes

Netz und Image entstehen gleichzeitig, der Container danach – OpenTofu baut aus den Referenzen einen Abhängigkeitsgraphen. -auto-approve überspringt die Rückfrage; im Alltag tippst du yes, nachdem du den Plan gelesen hast. Was angelegt wurde, steht im State, tofu state list zeigt die Adressen.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Ändern oder ersetzen?

Erst ein anderes Passwort für die Datenbank:

sed -i 's/lab-db-pw-123/lab-db-pw-456/' main.tf
tofu plan -no-color | grep -E 'must be replaced|forces replacement|Plan:'
sed -i 's/lab-db-pw-456/lab-db-pw-123/' main.tf

Erwartet:

  # docker_container.db must be replaced
      ~ env                                         = [ # forces replacement
Plan: 1 to add, 0 to change, 1 to destroy.

Eine Umgebungsvariable lässt sich in einem laufenden Container nicht ändern: OpenTofu löscht ihn und legt ihn neu an (-/+). Bei einer Datenbank ohne Volume wären die Daten weg – ein Plan mit „to destroy” verdient immer einen zweiten Blick.

Jetzt bekommt das Netz ein Label. sed … r datei fügt den Inhalt einer Datei hinter der passenden Zeile ein:

cat > label.txt <<'EOF'
  labels {
    label = "kurs"
    value = "tofu"
  }
EOF
sed -i '/^  name = "notes-tag01"$/r label.txt' main.tf
tofu plan -no-color | grep -E 'must be replaced|forces replacement|Plan:'
tofu apply -auto-approve -no-color 2>&1 | grep -E '^Error|Apply complete'

Erwartet (nach etwa 30 Sekunden):

  # docker_network.notes must be replaced
      + labels { # forces replacement
Plan: 1 to add, 0 to change, 1 to destroy.
Error: timeout while waiting for state to become 'removed' (last state: 'pending', ti…

Das Netz soll ersetzt werden, der Container aber nicht. Docker weigert sich, ein Netz zu löschen, an dem noch ein Container hängt. Warum hat OpenTofu den Container nicht mit ersetzt? Er verweist mit docker_network.notes.name auf den Namen – und der bleibt gleich. Für OpenTofu ändert sich am Container also nichts. Verweist er auf die ID, die sich beim Ersetzen ändert, erkennt OpenTofu die Abhängigkeit richtig:

sed -i 's/name = docker_network.notes.name/name = docker_network.notes.id/' main.tf
tofu plan -no-color | grep -E 'must be replaced|Plan:'
tofu apply -auto-approve -no-color | grep 'Apply complete'

Erwartet:

  # docker_container.db must be replaced
  # docker_network.notes must be replaced
Plan: 2 to add, 0 to change, 2 to destroy.
Apply complete! Resources: 2 added, 0 changed, 2 destroyed.

Merke: Referenzen auf Werte, die sich beim Ersetzen ändern (IDs), tragen Abhängigkeiten weiter. Referenzen auf Werte, die gleich bleiben (Namen), nicht.

Fortschritt speichern? Kostenlos registrieren

Drill 5: destroy

tofu destroy -auto-approve -no-color | grep -E 'Destroy complete'
docker ps -a --filter name=notes-db-tag01 --format '{{.Names}}' | wc -l
docker images postgres:18.6-alpine --format '{{.Repository}}:{{.Tag}}'
tofu state list | wc -l

Erwartet:

Destroy complete! Resources: 3 destroyed.
0
postgres:18.6-alpine
0

destroy entfernt alles, was im State steht – und nur das. Das Image bleibt, weil keep_locally = true sagt: beim Löschen der Ressource das Image nicht aus Docker entfernen.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

tofu validate -no-color

Erwartet:

Success! The configuration is valid.
tofu plan -no-color | grep 'Plan:'

Erwartet: alles wieder neu anzulegen.

Plan: 3 to add, 0 to change, 0 to destroy.
grep -c 'version     = "4.6.0"' .terraform.lock.hcl

Erwartet:

1

Challenge

Ergänze einen Container notes-web-tag01 aus dem Image nginx:1.31.8-alpine, der auf 127.0.0.1:8081 antwortet. Leg alles an, prüf mit curl und räum wieder ab.

Hinweis: Der Block ports hat internal, external und ip.

Lösung

cat >> main.tf <<'EOF'

resource "docker_image" "nginx" {
  name         = "nginx:1.31.8-alpine"
  keep_locally = true
}

resource "docker_container" "web" {
  name  = "notes-web-tag01"
  image = docker_image.nginx.image_id
  ports {
    internal = 80
    external = 8081
    ip       = "127.0.0.1"
  }
}
EOF
tofu apply -auto-approve -no-color | grep 'Apply complete'
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8081/
tofu destroy -auto-approve -no-color | grep 'Destroy complete'

Erwartet:

Apply complete! Resources: 5 added, 0 changed, 0 destroyed.
200
Destroy complete! Resources: 5 destroyed.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Plan speichern: tofu plan -out=plan.bin und danach tofu apply plan.bin führen genau das aus, was geprüft wurde – auch wenn sich zwischendurch etwas geändert hat. In der CI ist das Pflicht (Tag 14).
  • -auto-approve nur in Automatisierung, nie von Hand auf Produktion.
  • Ersetzen erkennen: lifecycle { prevent_destroy = true } lässt jeden Plan scheitern, der eine wichtige Ressource löschen würde – ein Sicherheitsgurt für Datenbanken und Speicher.