Azure zu STACKIT: Cutover- und Rollback-Runbook

Was der Lauf liefert und was nicht

Eine kleine Portal-Umgebung (VM, PostgreSQL, Storage Account, Key Vault und Netzwerk) wurde am 4. November 2026 bewertet. Sechs Einheiten, drei Wellen.

1. 01

   Wellen aus Abhängigkeiten

   migration/technical-sequencing.md ordnet die Einheiten nach ihren Abhängigkeiten. Einheiten einer Welle können parallel umziehen. Es ist ein Ausgangspunkt, kein Zeitplan.

2. 02

   Verantwortliche und Prüfungen

   execution/README.md führt die Schritte der Reihe nach mit einer Rolle auf, und execution/verify/checks.md nennt Prüfungen vor und nach jedem Schritt.

3. 03

   Rollback je Schritt

   Der Ausführungsplan sagt für jeden OpenTofu-Schritt, ob er sich rückgängig machen lässt. Für manuelle Schritte hält er fest, dass die ausführende Person den Rückweg dokumentiert.

4. 04

   Keine Cutover-Fakten

   Der Lauf fand keinen DNS-Eintrag, keine Neubindung öffentlicher Adressen und keine Zertifikatseinheit für das Cutover. Das heißt nicht, dass nichts umziehen muss: Namen, Adressen und Zertifikate außerhalb der gescannten Quelle bleiben unsichtbar.

Sequenzierung und Apply-Befehle

Links die drei Wellen des Laufs, rechts die Befehle, die das Ausführungspaket für den Entwurf nennt.

## Wave 1 — 4 unit(s)

| Unit | Class | Target |
|---|---|---|
| `azurerm_key_vault.portal` | RECONFIGURE / MEDIUM | STACKIT Secrets Manager (+ KMS for keys) |
| `azurerm_postgresql_flexible_server.portal` | REPLATFORM / MEDIUM | STACKIT PostgreSQL Flex |
| `azurerm_storage_account.docs` | REPLATFORM / MEDIUM | STACKIT Object Storage |
| `azurerm_virtual_network.app` | RECONFIGURE / MEDIUM | STACKIT project networking / Network Area (SNA) |

## Wave 2 — 1 unit(s)

| Unit | Class | Target |
|---|---|---|
| `azurerm_subnet.vm` | RECONFIGURE / MEDIUM | STACKIT network |

## Wave 3 — 1 unit(s)

| Unit | Class | Target |
|---|---|---|
| `azurerm_linux_virtual_machine.portal` | RECONFIGURE / MEDIUM | STACKIT Compute Engine |

cd terraform
tofu init
tofu validate
tofu plan -out=stackit.tfplan
tofu apply stackit.tfplan

• Nicht wie geschrieben anwenden

  Alle 7 OpenTofu-Schritte dieses Laufs sind als im aktuellen Plan nicht ausführbar markiert, und das Paket rät, erst anzuwenden, wenn jeder OpenTofu-Schritt ausführbar ist. Nutzen Sie den Entwurf als Basis für ein Testprojekt, nicht für das Produktivfenster.

• Zuerst die Variablen

  Sechs Variablen brauchen vor den Schritten einen Wert: Projekt-ID, erlaubte CIDRs der Datenbank, Storage-Klasse, Maschinentyp, Image-ID und Größe des Boot-Volumes.

Das Runbook

Schritte in Reihenfolge. Die verantwortlichen Rollen sind die, die der Lauf nennt. Schritte mit dem Vermerk „Praxis“ sind allgemeines Vorgehen, keine Ausgabe des Laufs.

Die Zeilen 1 bis 4 und 7 folgen dem Lauf. Die Zeilen 5, 6, 8, 9 und 10 sind allgemeine Praxis und hängen von Datenmenge und tolerierter Ausfallzeit ab, die die Quelle nicht nennt. OpenTofu wendet den ganzen Entwurf in einem Lauf an und ordnet die Blöcke nach ihren Referenzen; wer die Zeilen 3, 4 und 7 nacheinander anlegen will, setzt dafür selbst -target (Praxis).

Rollback und Prüfungen, wie der Lauf sie schreibt

Links die Rollback-Einträge zweier OpenTofu-Schritte, ein Auszug aus execution-plan.json mit den Werten, wie der Lauf sie geschrieben hat. Rechts die Prüfungen, die das Paket für die Zeit nach den Schritten nennt.

{
  "actions": [
    {
      "id": "TF/stackit_network.vm",
      "rollback": [
        {
          "capability": "AVAILABLE",
          "how": "tofu destroy -target=stackit_network.vm, or remove the block and apply"
        }
      ]
    },
    {
      "id": "TF/stackit_postgresflex_instance.portal",
      "rollback": [
        {
          "capability": "PARTIAL",
          "how": "tofu destroy -target=stackit_postgresflex_instance.portal, or remove the block and apply; what was written to it since it was created is lost"
        }
      ]
    }
  ]
}

## After each step

- [ ] `TF/stackit_network.vm` · `resource-exists` `address=stackit_network.vm` — `stackit_network.vm` exists in the STACKIT project (OpenTofu's state lists it).
- [ ] `TF/stackit_key_pair.portal` · `resource-exists` `address=stackit_key_pair.portal` — `stackit_key_pair.portal` exists in the STACKIT project (OpenTofu's state lists it).
- [ ] `TF/stackit_secretsmanager_instance.migrated_secrets` · `resource-exists` `address=stackit_secretsmanager_instance.migrated_secrets` — `stackit_secretsmanager_instance.migrated_secrets` exists in the STACKIT project (OpenTofu's state lists it).
- [ ] `TF/stackit_objectstorage_bucket.docs` · `resource-exists` `address=stackit_objectstorage_bucket.docs` — `stackit_objectstorage_bucket.docs` exists in the STACKIT project (OpenTofu's state lists it).
- [ ] `TF/stackit_postgresflex_instance.portal` · `resource-exists` `address=stackit_postgresflex_instance.portal` — `stackit_postgresflex_instance.portal` exists in the STACKIT project (OpenTofu's state lists it).
- [ ] `TF/stackit_network_interface.portal_1` · `resource-exists` `address=stackit_network_interface.portal_1` — `stackit_network_interface.portal_1` exists in the STACKIT project (OpenTofu's state lists it).
- [ ] `TF/stackit_server.portal` · `resource-exists` `address=stackit_server.portal` — `stackit_server.portal` exists in the STACKIT project (OpenTofu's state lists it).

• AVAILABLE und PARTIAL

  AVAILABLE heißt: Ein Destroy des Blocks macht den Schritt rückgängig (hier 4 Schritte). PARTIAL heißt dasselbe, doch was seither hineingeschrieben wurde, geht verloren (3 Schritte: Bucket, Datenbank und Server). Die 14 manuellen Schritte nimmt die Person zurück, die sie ausführt.

• Die Prüfungen sind Existenzprüfungen

  Die sieben Nachprüfungen bestätigen, dass eine Ressource im OpenTofu-State steht. Daten, Logins und Verkehr prüfen sie nicht; ergänzen Sie also eigene Tests.

Rollback-Regeln vor dem Fenster vereinbaren

• Den Punkt ohne Rückkehr festlegen

  Vor der letzten Synchronisation lässt sich alles zurücknehmen. Schreiben Clients erst auf STACKIT, bedeutet Rollback, Daten zurückzukopieren (Praxis).

• Die Datenbankinstanz schützen

  STACKIT hält fest: Das Löschen einer PostgreSQL-Flex-Instanz ohne Instanzschutz führt mit API v3 zu sofortigem, dauerhaftem Datenverlust. Aktivieren Sie den Schutz, bevor Sie sich auf Destroy verlassen.

• Keine In-place-Wiederherstellung

  PostgreSQL Flex stellt durch Klonen eines Backups in eine neue Instanz wieder her; die Clients müssen daher dorthin umgestellt werden. Planen Sie das in jeden Wiederherstellungsschritt ein.

• Manuelle Schritte brauchen einen schriftlichen Rückweg

  Bei manuellen Schritten weiß der Plan nicht, wie sie rückgängig zu machen sind. Die ausführende Person hält fest, wie.

• Die Quelle bis zum Ende der Haltefrist behalten

  Löschen Sie Azure-Ressourcen nicht im selben Fenster wie das Cutover (Praxis).

Fragen zu Cutover und Rollback

Quellen

• STACKIT-Dokumentation: PostgreSQL Flex
• STACKIT-Dokumentation: PostgreSQL Flex sichern und klonen
• STACKIT-Dokumentation: Daten mit rclone migrieren
• STACKIT-Dokumentation: Secrets Manager