Tag 10: Umgebungen – dev und prod
Ziel: Dieselbe Infrastruktur mehrfach betreiben – einmal mit Workspaces, einmal mit einem Verzeichnis je Umgebung – und die Vor- und Nachteile am eigenen Labor sehen. · Dauer: ca. 75 min · Voraussetzung: Tag 9
Briefing
- Eine Umgebung (dev, test, prod) ist dieselbe Konfiguration mit anderen Werten und vor allem mit eigenem State. Teilen sich zwei Umgebungen einen State, überschreibt die eine die andere (Tag 2, Challenge).
- Workspaces geben einem Verzeichnis mehrere States.
terraform.workspaceenthält den Namen des aktiven. Schnell eingerichtet – aber welcher gerade aktiv ist, sieht man der Befehlszeile nicht an. - Ein Verzeichnis je Umgebung (
envs/dev,envs/prod) mit eigenem Backend-Schlüssel und eigenen Werten. Mehr Dateien, dafür ist jeder Unterschied im Code sichtbar.
Workspaces: tag10/ws ─ workspace dev ─► S3: env:/dev/tag10/ws.tfstate
└ workspace prod ─► S3: env:/prod/tag10/ws.tfstate
Verzeichnisse: tag10/envs/dev ─► S3: tag10/dev.tfstate (dev.auto.tfvars)
tag10/envs/prod ─► S3: tag10/prod.tfstate (prod.auto.tfvars)
Drill 1: Workspaces
mkdir -p ~/tf-lab/tag10/ws && cd ~/tf-lab/tag10/ws
sed 's|tag05/terraform.tfstate|tag10/ws.tfstate|' ~/tf-lab/tag05/backend.tf > backend.tf
cp ~/tf-lab/tag05/versions.tf .
cat > main.tf <<'EOF'
provider "docker" {}
locals {
ports = { dev = 8091, prod = 8092 }
}
module "notes" {
source = "git::file:///home/ubuntu/tf-lab/module//notes-docker?ref=v1.1.0"
name = "ws-${terraform.workspace}"
port = local.ports[terraform.workspace]
db_passwort = "lab-db-pw-123"
}
output "url" {
value = module.notes.url
}
EOF
tofu init -no-color >/dev/null
tofu workspace new dev -no-color | head -1
tofu apply -auto-approve -no-color | grep 'Apply complete'
tofu workspace new prod -no-color | head -1
tofu apply -auto-approve -no-color | grep 'Apply complete'
tofu workspace list
tofu output -raw url; echo
s3ls 'tofu-state?list-type=2' | grep -o '<Key>[^<]*tag10[^<]*</Key>'Erwartet:
Created and switched to workspace "dev"!
Apply complete! Resources: 9 added, 0 changed, 0 destroyed.
Created and switched to workspace "prod"!
Apply complete! Resources: 9 added, 0 changed, 0 destroyed.
default
dev
* prod
http://127.0.0.1:8092
<Key>env:/dev/tag10/ws.tfstate</Key>
<Key>env:/prod/tag10/ws.tfstate</Key>
- Ein Verzeichnis, drei States:
default(leer),dev,prod. Im Bucket liegen die Workspaces unterenv:/<name>/. local.ports[terraform.workspace]wählt den Port nach dem Namen. Einen Workspace, der nicht in der Map steht, lehnt der Plan ab.- Der Kürze halber ohne
encryption.tf– in einem echten Projekt gehört sie auch hier hinein.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Die Falle
Ein neues Datenbank-Passwort, erst einmal nur für dev – aber welcher Workspace ist aktiv?
sed -i 's/lab-db-pw-123/lab-db-pw-456/' main.tf
tofu plan -no-color | grep -E 'must be replaced|Plan:'
tofu workspace showErwartet:
# module.notes.docker_container.api["a"] must be replaced
# module.notes.docker_container.db must be replaced
# module.notes.docker_container.migrate must be replaced
Plan: 3 to add, 0 to change, 3 to destroy.
prod
Gemeint war dev, geplant wird prod – Datenbank und Container würden
ersetzt. Bei Workspaces entscheidet ein unsichtbarer Zustand im
Verzeichnis .terraform, welche Umgebung du triffst. Darum
zeigen viele Teams den Workspace im Prompt an – oder verzichten für
echte Umgebungen ganz darauf.
sed -i 's/lab-db-pw-456/lab-db-pw-123/' main.tf
tofu workspace select dev -no-color
tofu plan -no-color | tail -1Erwartet:
Switched to workspace "dev".
No changes. Your infrastructure matches the configuration.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Ein Verzeichnis je Umgebung
mkdir -p ~/tf-lab/tag10/envs/{dev,prod} && cd ~/tf-lab/tag10/envs
for u in dev prod; do
sed "s|tag05/terraform.tfstate|tag10/$u.tfstate|" ~/tf-lab/tag05/backend.tf \
> $u/backend.tf
cp ~/tf-lab/tag05/versions.tf $u/
cat > $u/main.tf <<'EOF'
provider "docker" {}
variable "umgebung" { type = string }
variable "port" { type = number }
variable "instanzen" { type = set(string) }
module "notes" {
source = "git::file:///home/ubuntu/tf-lab/module//notes-docker?ref=v1.1.0"
name = "env-${var.umgebung}"
port = var.port
instanzen = var.instanzen
db_passwort = "lab-db-pw-123"
}
EOF
done
printf 'umgebung = "dev"\nport = 8093\ninstanzen = ["a"]\n' > dev/dev.auto.tfvars
printf 'umgebung = "prod"\nport = 8094\ninstanzen = ["a", "b"]\n' \
> prod/prod.auto.tfvars
diff dev/main.tf prod/main.tf && echo "gleicher Code"
diff dev/dev.auto.tfvars prod/prod.auto.tfvars
for u in dev prod; do
tofu -chdir=$u init -no-color >/dev/null
tofu -chdir=$u apply -auto-approve -no-color | grep 'Apply complete'
doneErwartet:
gleicher Code
1,3c1,3
< umgebung = "dev"
< port = 8093
< instanzen = ["a"]
---
> umgebung = "prod"
> port = 8094
> instanzen = ["a", "b"]
Apply complete! Resources: 9 added, 0 changed, 0 destroyed.
Apply complete! Resources: 10 added, 0 changed, 0 destroyed.
tofu -chdir=devarbeitet im Unterverzeichnis – wo du gerade stehst, spielt keine Rolle. Welche Umgebung gemeint ist, steht in der Befehlszeile.- Der Unterschied zwischen den Umgebungen ist genau eine Datei. Ein Review sieht sofort, was prod anders macht.
main.tfist in beiden Ordnern gleich. Größere Projekte legen sie einmal ab und binden sie per Modul ein – oder nutzen Werkzeuge wie Terragrunt.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Eine Änderung nur für dev
sed -i 's/^instanzen = \["a"\]$/instanzen = ["a", "c"]/' dev/dev.auto.tfvars
tofu -chdir=dev plan -no-color | grep -E 'will be created|Plan:'
tofu -chdir=prod plan -no-color | tail -1
tofu -chdir=dev apply -auto-approve -no-color | grep 'Apply complete'Erwartet:
# module.notes.docker_container.api["c"] will be created
Plan: 2 to add, 0 to change, 1 to destroy.
No changes. Your infrastructure matches the configuration.
Apply complete! Resources: 2 added, 0 changed, 1 destroyed.
Neue Instanz plus neuer Proxy (die nginx-Konfiguration ändert sich) – in dev, und nur dort. prod bleibt unberührt, weil es einen eigenen State und eigene Werte hat.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
for p in 8091 8093 8094; do curl -s -o /dev/null -w "$p %{http_code}\n" \
http://127.0.0.1:$p/healthz; doneErwartet: dev im Workspace, dev und prod im Verzeichnis.
8091 200
8093 200
8094 200
s3ls 'tofu-state?list-type=2' | grep -o '<Key>[^<]*tag10[^<]*' | wc -lErwartet:
4
cd ~/tf-lab/tag10/ws && tofu workspace showErwartet:
dev
Challenge
Die Workspace-Variante soll nur eine Umgebung behalten: Räume
prod im Workspace komplett ab und lösche den Workspace. Der
Container auf Port 8092 muss danach weg sein, dev auf 8091 läuft
weiter.
Hinweis: Einen Workspace kann man nur löschen, wenn sein State leer ist und er nicht aktiv ist.
Lösung
cd ~/tf-lab/tag10/ws
tofu workspace select prod -no-color
tofu destroy -auto-approve -no-color | grep 'Destroy complete'
tofu workspace select dev -no-color
tofu workspace delete prod -no-color
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8092/healthz
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8091/healthzErwartet:
Switched to workspace "prod".
Destroy complete! Resources: 9 destroyed.
Switched to workspace "dev".
Deleted workspace "prod"!
000
200
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Verzeichnisse für Umgebungen, Workspaces für Kopien: Workspaces passen für viele gleiche, kurzlebige Kopien (eine je Feature-Branch). Für dev/test/prod mit eigenen Rechten und Freigaben sind Verzeichnisse klarer.
- Eigene Zugangsdaten je Umgebung: prod bekommt einen eigenen Backend-Pfad mit eigenen Rechten und eigenen Provider-Zugängen. Wer nur dev ändern darf, kann prod dann gar nicht treffen.
- Gleicher Code, gleiche Version: Unterschiede zwischen Umgebungen gehören in Werte, nicht in abweichende Kopien des Codes. Ein Modul mit fester Version für alle macht das sicher.