Zum Inhalt springen
Trainingslager IT-Trainingslager

Anhang A: Spickzettel

Alles Wichtige aus Tag 0–15 auf wenigen Seiten. Die Zahl in Klammern ist der Tag, an dem du es geübt hast. Im Zweifel gelten tofu -help, tofu <befehl> -help und die Dokumentation unter opentofu.org/docs.

Der Arbeitsablauf

Befehl Was er tut Tag
tofu init Provider und Module laden, Backend einrichten 1
tofu init -upgrade neuere erlaubte Provider-Versionen holen 15
tofu fmt / -check formatieren / nur prüfen 13
tofu validate Syntax, Typen, Referenzen prüfen 13
tofu plan Soll und Ist vergleichen 1
tofu plan -out=x.plan Plan speichern 13
tofu apply / tofu apply x.plan ausführen / gespeicherten Plan 1, 14
tofu destroy alles aus dem State abbauen 1
tofu output / -raw name Ausgänge / ein Wert ohne Anführungszeichen 2
tofu console Ausdrücke ausprobieren 0
tofu test *.tftest.hcl ausführen 13
tofu show -json x.plan Plan als JSON (für Conftest) 13

Nützliche Schalter:

Schalter Wirkung Tag
-auto-approve keine Rückfrage – nur in Automatisierung 1
-var 'x=1', -var-file=prod.tfvars Werte von außen 2
-replace=adresse Ressource neu anlegen 3
-target=adresse nur diese Ressource – Notbehelf 3
-refresh-only nur den State an die Wirklichkeit anpassen 3
-detailed-exitcode Exit 0 = nichts, 1 = Fehler, 2 = Änderungen 14
-lock-timeout=30s auf eine Sperre warten 15
-chdir=verzeichnis in einem anderen Verzeichnis arbeiten 10
-generate-config-out=x.tf Konfiguration für Importe vorschlagen 11

Plan lesen

Zeichen Bedeutung Tag
+ anlegen 1
~ an Ort und Stelle ändern 1
-/+ löschen und neu anlegen (# forces replacement) 1
- löschen 1
has moved to Umbenennung per moved 11
will be removed from the OpenTofu state removed, destroy = false 11
(sensitive value) / (write-only attribute) Wert verborgen / nie gespeichert 12

Sprache

variable "port" {                             # (2)
  type    = number
  default = 8080
  validation {                                # (13)
    condition     = var.port >= 1024
    error_message = "zu klein"
  }
}
locals { name = "notes-${var.umgebung}" }     # (2)
resource "docker_volume" "db" {               # (1)
  for_each = toset(["a", "b"])                # (4) – count = 2 ginge auch
  name     = "${local.name}-${each.key}"
  lifecycle {
    prevent_destroy = true                    # (4)
    ignore_changes  = [labels]                # (6)
  }
}
data "docker_image" "api" { name = "notes-api:0.4.0" }        # (4)
module "notes" { source = "git::file:///…//notes-docker?ref=v1.2.0" }   # (5)
output "url" { value = module.notes.url }     # (2)
Ausdruck Ergebnis Tag
[for k, v in m : "${k}=${v}"] Liste aus einer Map 4
{ for n in l : n => upper(n) } Map aus einer Liste 4
dynamic "block" { for_each = … } Blöcke wiederholen 4
templatefile("x.tftpl", { … }) Datei mit Platzhaltern füllen 2
yamlencode(…), jsonencode(…) Werte als YAML/JSON 7
pathexpand("~") Home-Verzeichnis 7
sha256(x) Prüfsumme, etwa als Annotation 6
one(menge), strcontains(t, x) einziges Element, enthält 13
terraform.workspace Name des Workspaces 10

State

Befehl Was er tut Tag
tofu state list alle Adressen 1
tofu state show adresse eine Ressource im Detail 3
tofu state pull ganzer State als JSON 3
tofu state rm adresse aus dem State entfernen, Ressource bleibt 15
tofu force-unlock ID verwaiste Sperre lösen 9, 15
tofu import adresse id sofort importieren (ohne Plan) 11
tofu workspace new/select/list/show/delete Workspaces 10

Blöcke statt Befehle – sie laufen durch Review und Plan:

import  { to = docker_volume.x, id = "name" }                  # (11)
moved   { from = docker_volume.alt, to = docker_volume.neu }   # (11)
removed {                                                      # (11)
  from = docker_network.netz
  lifecycle { destroy = false }
}

Backend und Verschlüsselung (Tag 9):

terraform {
  backend "s3" {
    bucket       = "tofu-state"
    key          = "tag05/terraform.tfstate"
    use_lockfile = true
    # endpoints, use_path_style, skip_* für S3-kompatible Speicher
  }
  encryption {
    key_provider "pbkdf2" "lab" { passphrase = var.state_passphrase }
    method "aes_gcm" "lab" { keys = key_provider.pbkdf2.lab }
    state { method = method.aes_gcm.lab }
  }
}

Secrets

Mittel schützt Tag
sensitive = true Ausgabe (Plan, Log) 12
*.auto.tfvars in .gitignore, TF_VAR_name Code 12
ephemeral = true, ephemeral "…" Plan und State 12
Attribute auf _wo + _wo_revision State, Wert erreicht trotzdem das Ziel 12
State-Verschlüsselung State im Bucket 9

Qualität und CI

Werkzeug Befehl Tag
tflint tflint 13
tofu test tofu test, -filter=tests/x.tftest.hcl 13
Trivy trivy config --severity HIGH,CRITICAL --exit-code 1 . 13
Conftest conftest test -p policy plan.json 13
tea tea pr create, tea pr merge 1, tea actions runs list 14
tea tea actions workflows dispatch x.yml --ref main --follow 14

Fehlerbilder

Meldung Ursache Tag
timeout while waiting for state … 'removed' Bezug über Namen statt ID 1
Resource instance cannot be destroyed prevent_destroy 4
hashicorp/docker: provider registry … does not have required_providers fehlt 5
Error acquiring the state lock Sperre aktiv oder verwaist 9, 15
decryption failed for all provided methods falsche Passphrase 9, 15
Ephemeral value used in non-ephemeral context ephemer in normalem Attribut 12
Output refers to sensitive values Output ohne sensitive = true 12
Conflict. The container name … is already in use Ressource fehlt im State 15
no available releases match the given constraints Version gibt es nicht 15
invalid ref Modulversion nicht veröffentlicht 15

Terraform-Unterschiede

  • Registry: registry.opentofu.org statt registry.terraform.io – die Provider sind dieselben (1).
  • State-Verschlüsselung (encryption) gibt es nur in OpenTofu (9).
  • Befehle, Sprache, Backends, import/moved/removed, tofu test (bei Terraform terraform test) und write-only-Attribute funktionieren in beiden.