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 |
- 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.