Refaktorera state med moved och removed

Det klassiska tillvägagångssättet är terraform state mv, som skriver om en resurs adress i state. Här byter vi namn på en instans från aws_instance.web till aws_instance.app.

state mv är en manuell CLI-åtgärd som utförs en gång. Den dokumenteras inte i koden, så teammedlemmar som genomför samma ändring på sina datorer måste upprepa den. Det är felbenäget i samarbetande arbetsflöden.

Blocket moved registrerar ett namnbyte i din konfiguration. Terraform tillämpar det automatiskt för alla under nästa planering, och därefter kan du ta bort blocket.

moved-block hanterar även att kapsla in resurser i en modul. Mål adressen innehåller modulens sökväg.

När du har lagt till ett moved-block kör du terraform plan. En korrekt flytt visar varken förstöring eller skapande, utan bara en adressändring. Om du fortfarande ser att resursen ska ersättas är blocket felaktigt.

Ibland vill du att Terraform ska sluta hantera en resurs utan att den verkliga infrastrukturen förstörs. Det imperativa kommandot är terraform state rm.

Nyare versioner av Terraform stöder ett removed-block. Med lifecycle { destroy = false } glömmer Terraform resursen från state men lämnar den verkliga infrastrukturen orörd.

För stora projekt kan terraform state mv -state-out flytta resurser mellan separata state-filer. Det är användbart när en monolit delas upp i stackar som tillämpas oberoende av varandra.

Terraform skriver en .backup-fil innan state ändras. Med fjärranslutna backends bör du ändå alltid bekräfta att state inte är låst av en teammedlem innan manuella åtgärder, för att undvika korruption.

Nu kan du strukturera om infrastrukturen utan att förstöra den:

• state mv / state rm för imperativa ändringar.
• moved-block för deklarativa namnbyten.
• removed-block för att glömma resurser utan att förstöra dem.
• Verifiera alltid med en plan som inte visar någon ersättning.