State mit moved und removed umstrukturieren

Wenn Sie eine Ressource in Ihrer Konfiguration umbenennen, sieht Terraform die alte Adresse als entfernt und eine neue als hinzugefügt. Standardmäßig wird die Ressource zerstört und neu erstellt, was zu Ausfallzeiten oder Datenverlust führen kann.

Tools zur Zustandsrefaktorierung ermöglichen es Ihnen, Terraform mitzuteilen, dass eine Ressource lediglich verschoben wurde.

Beginnen Sie mit einer Liste der im Zustand erfassten Elemente. Der Befehl terraform state list zeigt die Adresse jeder verwalteten Ressource.

Der klassische Ansatz ist terraform state mv. Damit wird die Adresse einer Ressource im Zustand neu geschrieben. Hier benennen wir eine Instanz von aws_instance.web in aws_instance.app um.

state mv ist eine manuelle, einmalige CLI-Aktion. Sie wird nicht im Code festgehalten, sodass Teammitglieder, die dieselbe Änderung auf ihren Rechnern ausführen, sie wiederholen müssen. Das ist in kollaborativen Arbeitsabläufen fehleranfällig.

Der moved-Block hält eine Umbenennung in Ihrer Konfiguration fest. Terraform wendet sie beim nächsten Plan automatisch für alle an; anschließend können Sie den Block entfernen.

moved-Blöcke unterstützen auch das Verschachteln von Ressourcen in einem Modul. Die Zieladresse enthält den Modulpfad.

Führen Sie nach dem Hinzufügen eines moved-Blocks terraform plan aus. Bei einer korrekten Verschiebung werden weder Zerstörung noch Erstellung angezeigt, sondern nur eine Adressänderung. Wenn weiterhin ein Ersetzen angezeigt wird, ist der Block falsch.

Manchmal soll Terraform eine Ressource nicht mehr verwalten, ohne die tatsächliche Infrastruktur zu zerstören. Der imperative Befehl dafür ist terraform state rm.

Neuere Terraform-Versionen unterstützen einen removed-Block. Mit lifecycle { destroy = false } wird die Ressource aus dem Zustand entfernt, während die tatsächliche Infrastruktur unverändert bleibt.

Bei großen Projekten kann terraform state mv -state-out Ressourcen zwischen separaten Zustandsdateien verschieben. Das ist nützlich, wenn ein Monolith in unabhängig angewendete Stacks aufgeteilt wird.

Terraform schreibt vor einer Änderung des Zustands eine .backup-Datei. Bei Remote-Backends sollten Sie dennoch immer prüfen, dass der Zustand nicht von einem Teammitglied gesperrt ist, bevor Sie manuelle Vorgänge ausführen, um Beschädigungen zu vermeiden.

Sie können Ihre Infrastruktur nun umstrukturieren, ohne sie zu zerstören:

• state mv / state rm für imperative Änderungen.
• moved-Blöcke für deklarative Umbenennungen.
• removed-Blöcke zum Vergessen von Ressourcen ohne deren Zerstörung.
• Überprüfen Sie stets mit einem Plan, der kein Ersetzen anzeigt.