Wenn Sie mit Infrastructure Manager (Infra Manager) arbeiten möchten, sollten Sie mit Terraform vertraut sein. Weitere Informationen zu Terraform finden Sie unter Was ist Terraform?.
Mit Infra Manager werden Infrastrukturressourcen und -konfigurationen bereitgestellt, die in einer Terraform-Konfiguration definiert sind. Diese Konfigurationen können aus mehreren Dateien und Verzeichnissen bestehen, ihr Einstiegspunkt muss jedoch ein Terraform-Stammmodul sein.
Infra Manager verwendet den Begriff Blueprint für eine Terraform-Konfiguration.
Weitere Informationen zu Terraform mit Google Cloudfinden Sie unter Terraform auf Google Cloud.
Terraform-Module für Google Cloud
Eine Reihe von Modulen zum Bereitstellen von Google Cloud -Ressourcen finden Sie unter Terraform-Blueprints und -Module für Google Cloud.
Sie können auch eigene Terraform-Module für Google Clouderstellen. Weitere Informationen finden Sie unter Module erstellen.
Unterstützte Terraform-Versionen
Infra Manager unterstützt die folgenden 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 |
Mit dem Flag --tf-version-constraint können Sie die Version von Terraform angeben, die Infra Manager zum Erstellen einer Bereitstellung verwendet.
Bevor Sie Infrastructure Manager zum Bereitstellen einer Terraform-Konfiguration verwenden, muss die Konfiguration die folgenden Einschränkungen erfüllen:
Wenn Sie keine Terraform-Version angeben, wird standardmäßig die neueste unterstützte Version verwendet.
Wenn Sie eine Bereitstellung aktualisieren, können Sie ein Upgrade auf eine neuere Terraform-Version durchführen, aber kein Downgrade auf eine frühere unterstützte Version. Informationen zur Einstellung von Terraform-Versionen finden Sie in der Dokumentation zur Richtlinie zur Verwaltung von Terraform-Versionen.
Informationen dazu, welche Version von Terraform zum Erstellen einer bestimmten Bereitstellung oder Revision verwendet wurde, finden Sie unter Details einer Bereitstellung ansehen und Details einer Revision ansehen.
Einschränkungen für Terraform-Konfigurationen
Wenn Sie Infrastructure Manager zum Bereitstellen einer Terraform-Konfiguration verwenden möchten, muss die Konfiguration die folgenden Einschränkungen erfüllen:
- Geben Sie keine personenbezogenen oder vertraulichen Informationen in Terraform-Konfigurationswerten an. Weitere Informationen finden Sie unter Terraform-Konfigurationswerte und vertrauliche Daten.
- Es muss ein gültiges Terraform-Stammmodul angegeben werden. Die Erstellung von Vorlagen oder die Generierung von Terraform wird nicht unterstützt.
- Die Konfiguration muss mit einer unterstützten Version von Terraform ausführbar sein.
- Backend-Blöcke sollten nicht definiert werden.
- Wir raten davon ab, Bereitstellungstools zu verwenden. Verwenden Sie nach Möglichkeit eine andere Lösung. Weitere Informationen zu dieser Empfehlung finden Sie unter Bereitsteller sind das letzte Mittel. Wenn Sie Provisioner verwenden, beachten Sie, dass sich die Infra Manager-Laufzeitumgebung jederzeit ändern kann.
Terraform-Konfigurationswerte und vertrauliche Daten
Geben Sie keine personenidentifizierbaren oder sensiblen Informationen in Terraform-Konfigurationswerten an.
In der Dokumentation für den Google Cloud Bereitsteller sind Konfigurationswerte angegeben, die möglicherweise vertrauliche Daten enthalten.
Mit der Ressource google_storage_bucket_object kann beispielsweise ein Cloud Storage-Objekt mit dem Argument content erstellt werden. Dieses Argument ist auf der Seite google_storage_bucket_object der Google Cloud Anbieterdokumentation als vertraulich gekennzeichnet.
Sie können diese Labels verwenden, um sich beim Erstellen von Terraform-Konfigurationen oder beim Überprüfen einer vorhandenen Terraform-Konfiguration vor der Verwendung zu orientieren.
In den Google Cloud -Datenschutzhinweisen finden Sie Informationen dazu, wie Google Cloud personenbezogene Daten verarbeitet, die während der Bereitstellung und Verwaltung der Cloud-Dienste erhoben oder generiert werden.
Terraform-Anbieter für Google Cloudverwenden
Optional können Sie die gcloud CLI verwenden, um Bereitstellungen und Vorschauen so zu konfigurieren, dass von Infra Manager verwaltete Terraform-Provider fürGoogle Cloudverwendet werden.
Infra Manager unterstützt Terraform-Anbieter für Google Cloud:
googlegoogle-beta
Lassen Sie dieses Feld weg, um den von HashiCorp verwalteten Terraform-Anbieter für Google Cloud zu verwenden.
Informationen dazu, wie Sie die Verwendung eines von Infra Manager verwalteten Terraform-Anbieters angeben, finden Sie unter Infrastruktur mit Infrastructure Manager bereitstellen, Bereitstellung aktualisieren oder Vorschau einer Bereitstellung ansehen.
Unterstützte Versionen des Anbieters prüfen
Wenn Sie die Versionen eines Terraform-Anbieters für Google Cloud prüfen möchten, die von Infra Manager unterstützt werden, sehen Sie sich die manifest.json im Cloud Storage-Bucket an, der von Infra Manager verwaltet wird und der Region Ihrer Bereitstellung zugeordnet ist. Das Format ist:
https://storage.googleapis.com/LOCATION-im-providers/hashicorp/PROVIDER_VERSION/manifest.json
Eine vollständige Liste der unterstützten Versionen finden Sie im Feld versions der Datei manifest.json.
Wenn sich Ihre Bereitstellung beispielsweise in der Region africa-south1 befindet und Sie den Anbieter google-beta verwenden, rufen Sie https://storage.googleapis.com/africa-south1-im-providers/hashicorp/google-beta/manifest.json auf, um die verfügbaren Regionen aufzurufen.
Nächste Schritte
- Weitere Informationen zu Infrastructure Manager
- Bereitstellung erstellen
- Deployment aktualisieren
- Status einer Bereitstellung ansehen
- Deployment löschen