Zum Inhalt springen
Trainingslager IT-Trainingslager

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.workspace enthä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 unter env:/<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 show

Erwartet:

  # 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 -1

Erwartet:

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'
done

Erwartet:

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=dev arbeitet 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.tf ist 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; done

Erwartet: 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 -l

Erwartet:

4
cd ~/tf-lab/tag10/ws && tofu workspace show

Erwartet:

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/healthz

Erwartet:

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.