Tag 1: Erste Ressourcen mit dem Docker-Provider
Ziel: Eine erste Konfiguration schreiben, mit
init,plan,applyunddestroyden 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 initlädt die Provider und schreibt ihre genauen Versionen in die Lock-Datei.terraform.lock.hcl.tofu planvergleicht Soll und Ist und zeigt die Änderungen:+anlegen,~ändern,-/+ersetzen,-löschen.tofu applyfü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.hclErwartet:
- 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.6erlaubt 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_idist 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 ausregistry.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 listErwartet (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.tfErwartet:
# 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 -lErwartet:
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-colorErwartet:
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.hclErwartet:
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.binund danachtofu apply plan.binfü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-approvenur 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.