Richtlinie zur Terraform-Versionsverwaltung

Infrastructure Manager verwendet bestimmte Versionen von Terraform, um Ihre Google Cloud Ressourcen bereitzustellen und zu verwalten. Um Zugriff auf neue Funktionen zu ermöglichen und Sicherheitslücken zu schließen, aktualisiert Infra Manager regelmäßig die verfügbaren Terraform-Versionen.

In diesem Dokument wird die Richtlinie für die Verwaltung des Lebenszyklus dieser Versionen beschrieben. Die Richtlinie zur Terraform-Versionsverwaltung bietet einen transparenten und vorhersehbaren Prozess für die Einführung neuer Versionen und die Einstellung von Versionen für Infra Manager.

So funktioniert die Richtlinie

Infra Manager veröffentlicht eine Liste der verfügbaren Terraform-Versionen und ihres Supportstatus. Jede Version durchläuft einen Lebenszyklus, der Verfügbarkeit, Einstellung und Ende des Supports umfasst.

Diese Tabelle enthält Informationen zur Einstellung von Terraform-Versionen:

Terraform-Version Verfügbar ab Einstellungsdatum Enddatum des Supports Automatische Migration zur Version
1.2.3 21.08.2023 08.01.2026 08.02.2026 1.5.7
1.3.10 14.03.2024 TBD TBD TBD
1.4.7 14.03.2024 TBD TBD TBD
1.5.7 14.03.2024 TBD TBD TBD

Die Spalten in der Tabelle stehen für Folgendes:

  • Terraform-Version: Die Kennung der Terraform-Version.
  • Verfügbar ab: Das Datum, an dem die Version in Infra Manager verfügbar wird.
  • Einstellungsdatum: Das Datum, an dem die Version eingestellt werden soll. Danach wird beim Erstellen oder Aktualisieren von Bereitstellungen mit dieser Version eine Warnung ausgegeben.

  • Ende des Supportzeitraums: Das Datum, an dem die Version nicht mehr unterstützt wird. Dieser Zeitraum endet 180 Tage (oder länger) nach der Einstellung.

  • Automatische Migration zu Version: Die Version, zu der Bereitstellungen nach dem Ende des Supportzeitraums automatisch migriert werden (wenn Sie die automatische Migration aktiviert haben).

Eine aktuelle Liste der unterstützten Versionen und ihrer Lebenszyklusdaten finden Sie unter Unterstützte Terraform-Versionen.

Prozess zur Einstellung von Versionen

Wenn eine Terraform-Version das Einstellungsdatum erreicht, beginnt ein Einstellungszeitraum, der vor dem Enddatum des Supports liegt.

Wenn eine Version eingestellt wird, gilt Folgendes:

  • Die öffentliche Dokumentation wird mit dem Datum der Einstellung und dem Datum des Endes des Supports aktualisiert.
  • Wenn Sie eine Bereitstellung oder Vorschau mit der eingestellten Version erstellen oder aktualisieren, wird eine Warnung zurückgegeben. Diese Warnung besagt, dass die Version verworfen wurde, und enthält das Datum, an dem der Support endet.

Nach Ablauf des Endes des Supportzeitraums für eine Version wird diese als veraltet markiert. Wenn Sie versuchen, mit einer veralteten Version ein neues Deployment zu erstellen, schlägt der Vorgang mit einem Fehler fehl. Wenn Sie versuchen, eine vorhandene Bereitstellung zu aktualisieren, die auf eine veraltete Version verweist, hängt das Verhalten von der Richtlinie Ihrer Organisation für die automatische Migration ab.

Prozess für die Verfügbarkeit von Versionen

Wenn eine neue stabile Version von Terraform verfügbar ist, wird sie der Liste der unterstützten Versionen hinzugefügt. Die neue Terraform-Version ist in der Google Cloud Console, der gcloud CLI und der API verfügbar. Die Versionsverwaltungstabelle wird mit der neuen Version und dem Verfügbarkeitsdatum aktualisiert und es wird eine Infra Manager-Versionshinweis erstellt.

Automatische Migration

Wenn Sie ein vorhandenes Deployment aktualisieren, für das eine nicht unterstützte Version verwendet wird, kann Infra Manager das Deployment automatisch auf eine unterstützte Version aktualisieren. Diese Funktion für die automatische Migration ist ein Opt-in-Prozess, den Sie über eine Organisationsrichtlinie konfigurieren.

Wenn Sie die automatische Migration nicht aktiviert haben, schlägt jeder Aktualisierungsvorgang für eine Bereitstellung fehl, die eine nicht unterstützte Version verwendet. Um fortzufahren, müssen Sie die Bereitstellungskonfiguration manuell ändern, um eine unterstützte Version anzugeben, und den Vorgang dann noch einmal versuchen.

Richtlinie für die automatische Migration konfigurieren

Sie können die Richtlinie für die automatische Migration für Terraform-Versionen in Infra Manager mit der Google Cloud CLI konfigurieren.

So aktivieren Sie Ihre Richtlinie zur automatischen Migration:

gcloud infra-manager automigrationconfig enable-auto-migration --project=PROJECT_ID --location=LOCATION

So beschreiben Sie Ihre Richtlinie zur automatischen Migration:

gcloud infra-manager automigrationconfig describe --project=PROJECT_ID --location=LOCATION

Nächste Schritte