Vorschau eines Updates für eine Bereitstellung ansehen

Auf dieser Seite wird beschrieben, wie Sie mit Infrastructure Manager eine Vorschau der Bereitstellung von Ressourcen anzeigen, die in einer Terraform-Konfiguration definiert sind.

In einer Vorschau werden die Aktionen beschrieben, die zum Aktivieren einer bestimmten Terraform-Konfiguration erforderlich sind. Bevor Sie ein neues Deployment erstellen oder ein Deployment aktualisieren, können Sie sich eine Vorschau des Deployments ansehen, um die Ressourcen zu prüfen, die bereitgestellt werden sollen.

In einer Vorabversion wird der Befehl Terraform plan ausgeführt. Auf dieser Seite wird davon ausgegangen, dass Sie mit Terraform vertraut sind. Weitere Informationen finden Sie unter Terraform und Infrastructure Manager.

Damit eine Vorschau erstellt werden kann, muss die Terraform-Konfiguration mit einer der unterstützten Terraform-Versionen kompatibel sein.

Hinweis

  1. Infra Manager aktivieren.
  2. Prüfen Sie, ob Sie die IAM-Berechtigungen haben, die zum Erstellen von Vorabversionen erforderlich sind: roles/config.admin.
  3. Sie benötigen ein Dienstkonto mit den erforderlichen Berechtigungen. Weitere Informationen finden Sie unter Dienstkonto konfigurieren.
  4. Identifizieren Sie die Terraform-Konfiguration, für die Sie eine Vorschau anzeigen möchten. Achten Sie darauf, dass diese Terraform-Konfiguration den Einschränkungen entspricht und keine sensiblen Daten enthält.

Vorschau eines Updates für eine Bereitstellung ansehen

Die Terraform-Konfiguration, die Sie zum Aktualisieren eines Deployments verwenden, kann sich in einem Storage-Bucket oder in einem Git-Repository befinden.

Sie verwenden diese Terraform-Konfiguration auch, um eine Vorschau des Updates zu sehen.

Vorschau mit einer Terraform-Konfiguration, die in einem Cloud Storage-Bucket gespeichert ist

Wenn Sie ein Deployment aktualisieren, ändern sich einige der vorhandenen Ressourcen möglicherweise nicht. In der Vorschau eines Updates sehen Sie, welche Ressourcen bereitgestellt oder gelöscht werden sollen und welche Ressourcen nicht geändert werden sollen.

  1. Ermitteln Sie die Bereitstellung, die Sie aktualisieren möchten.

  2. Achten Sie darauf, dass die Terraform-Konfiguration in einen Cloud Storage-Bucket hochgeladen wurde. Weitere Informationen finden Sie unter Konfiguration in einen Storage-Bucket hochladen.

    Mit einem Storage-Bucket können Sie den Zugriff auf die Konfiguration steuern. Sie können auch eine Terraform-Konfiguration bereitstellen, die in einem Git-Repository oder auf Ihrem lokalen Computer gespeichert ist.

  3. So rufen Sie eine Vorschau des Updates auf:

    
    












































    gcloud infra-manager previews create projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID \
--service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \
--deployment=projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \
--gcs-source gs://BUCKET_NAME/OBJECT_NAME \
--input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \
--tf-version-constraint=TERRAFORM_VERSION \
--provider-source=SERVICE_MAINTAINED

    Ersetzen Sie:

    • PROJECT_ID ist die Projekt-ID, in der Infrastructure Manager ausgeführt wird.
    • LOCATION ist der Standort, an dem Infra Manager ausgeführt wird. Eine Liste der gültigen Standorte finden Sie unter Infrastructure Manager-Standorte.
    • PREVIEW_ID ist die von Ihnen angegebene Vorschaukennung. Weitere Informationen zu Einschränkungen für die Vorschaukennung finden Sie unter Vorschauname.
    • SERVICE_ACCOUNT ist der Name des Dienstkontos, das Sie zum Aufrufen von Infra Manager verwenden.
    • SERVICE_ACCOUNT_PROJECT_ID ist die Projekt-ID des Dienstkontos. In der Regel ist dies dasselbe Projekt, in dem Infra Manager ausgeführt wird.
    • DEPLOYMENT_ID ist die Bereitstellungs-ID der Bereitstellung, die Sie aktualisieren möchten.
    • BUCKET_NAME ist der Name des Storage-Buckets, in dem die Konfiguration gespeichert ist.

    • OBJECT_NAME ist der Objektname der Konfigurationsdatei. Dieses Objekt kann ein Verzeichnis oder eine ZIP-Datei, aber keine Terraform-Datei sein. Wenn Sie die Objektversionsverwaltung verwenden, können Sie auch die Generationsnummer des Objekts angeben. Weitere Informationen finden Sie unter Versionierte Objekte verwenden.

      Wenn der Storage-Bucket der Stammpfad der Terraform-Konfiguration ist, ist OBJECT_NAME optional.

    • INPUT_1_NAME=VALUE und INPUT_2_NAME=VALUE: Alle Eingabewerte in der Terraform-Konfiguration, einschließlich derer, die nicht standardmäßig definiert sind. Beispielsweise können Sie das Projekt, in dem Sie die Ressourcen bereitstellen, als project_id=my-project angeben.

      Wenn alle Eingabewerte standardmäßig in der Konfiguration definiert sind, ist dieses Flag optional.

    • Optional: TERRAFORM_VERSION: die Terraform-Version, die Infrastructure Manager für die Vorschau des Bereitstellungsupdates verwenden soll. Eine Liste der unterstützten Versionen finden Sie unter Unterstützte Terraform-Version. Wenn Sie dieses optionale Flag entfernen, verwendet Infra Manager die Terraform-Version der vorhandenen Bereitstellung oder standardmäßig die neueste unterstützte Kostenlose Stufe-Version (1.5.7). Für Vorabversionen fallen keine Gebühren für kostenpflichtige Terraform-Versionen an.

    • Optional: PROVIDER_SOURCE: Bestimmt, welchen Terraform-Anbieter für Google Cloud die Bereitstellung verwendet wird. Legen Sie SERVICE_MAINTAINED fest, um den von Infra Manager verwalteten Terraform-Anbieter zu verwenden. Lassen Sie dieses Feld weg, um den von HashiCorp verwalteten Terraform-Anbieter zu verwenden. Weitere Informationen finden Sie unter Terraform-Anbieter für Google Cloudverwenden.

    Felder aus der Bereitstellung wie die Terraform-Konfiguration, Variablen und das Dienstkonto werden automatisch in die Vorschau eingefügt, sofern Sie im Vorschaubefehl keine neuen Werte angeben.

Nachdem Sie eine Vorabversion erstellt haben, können Sie die Ergebnisse exportieren und ansehen, um den Plan für die Bereitstellung zu prüfen.

Vorschau mit einer in einem Git-Repository gespeicherten Terraform-Konfiguration

Wenn Sie ein Deployment aktualisieren, ändern sich einige der vorhandenen Ressourcen möglicherweise nicht. In der Vorschau eines Updates sehen Sie, welche Ressourcen bereitgestellt oder gelöscht werden sollen und welche Ressourcen nicht geändert werden sollen.

  1. Wenn Ihre Terraform-Konfiguration in einem privaten Git-Repository gespeichert ist und Sie dies noch nicht getan haben, müssen Sie eine Verbindung zu Ihrem GitHub-Host und GitHub-Repository herstellen. Verwenden Sie dazu Cloud Build, um Infra Manager Zugriff auf Ihr Repository zu gewähren.

  2. So aktualisieren Sie ein Deployment:

    
    












































    gcloud infra-manager previews create projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID \
--service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \
--deployment=projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \
--git-source-repo="GIT_REPO" \
--git-source-directory="DIRECTORY" \
--git-source-ref="REF" \
--input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \
--tf-version-constraint=TERRAFORM_VERSION \
--provider-source=SERVICE_MAINTAINED

    Ersetzen Sie:

    • PROJECT_ID ist die Projekt-ID, in der Infrastructure Manager ausgeführt wird.
    • LOCATION ist der Standort, an dem Infra Manager ausgeführt wird. Eine Liste der gültigen Standorte finden Sie unter Infrastructure Manager-Standorte.
    • PREVIEW_ID ist die von Ihnen angegebene Vorschaukennung. Weitere Informationen zu Einschränkungen für die Vorschaukennung finden Sie unter Vorschauname.
    • SERVICE_ACCOUNT ist der Name des Dienstkontos, das Sie zum Aufrufen von Infra Manager verwenden.
    • SERVICE_ACCOUNT_PROJECT_ID ist die Projekt-ID des Dienstkontos. In der Regel ist dies dasselbe Projekt, in dem Infra Manager ausgeführt wird.
    • DEPLOYMENT_ID ist die Bereitstellungs-ID der Bereitstellung, die Sie aktualisieren möchten.
    • GIT_REPO: das Git-Repository.
    • DIRECTORY: das Verzeichnis mit der Terraform-Konfiguration.
    • REF: die Git-Referenz der Konfiguration. Die Referenz ist optional. Wenn Sie die Referenz nicht angeben, wird der standardmäßig konfigurierte Zweig des Git-Repositorys verwendet.

    • INPUT_1_NAME=VALUE und INPUT_2_NAME=VALUE: Alle Eingabewerte in der Terraform-Konfiguration, einschließlich derer, die nicht standardmäßig definiert sind. Beispielsweise können Sie das Projekt, in dem Sie die Ressourcen bereitstellen, als project_id=my-project angeben.

      Wenn alle Eingabewerte standardmäßig in der Konfiguration definiert sind, ist dieses Flag optional.

    • Optional: TERRAFORM_VERSION: die Terraform-Version, die Infra Manager für die Vorschau des Bereitstellungsupdates verwenden soll. Eine Liste der unterstützten Versionen finden Sie unter Unterstützte Terraform-Version. Wenn Sie dieses optionale Flag entfernen, verwendet Infra Manager die Terraform-Version der vorhandenen Bereitstellung oder standardmäßig die neueste unterstützte Kostenlose Stufe-Version (1.5.7). Für Vorabversionen fallen keine Gebühren für kostenpflichtige Terraform-Versionen an.

    • Optional: PROVIDER_SOURCE: Bestimmt, welchen Terraform-Anbieter für Google Cloud die Bereitstellung verwendet wird. Legen Sie SERVICE_MAINTAINED fest, um den von Infra Manager verwalteten Terraform-Anbieter zu verwenden. Lassen Sie dieses Feld weg, um den von HashiCorp verwalteten Terraform-Anbieter zu verwenden. Weitere Informationen finden Sie unter Terraform-Anbieter für Google Cloudverwenden.

Felder aus der Bereitstellung wie die Terraform-Konfiguration, Variablen und das Dienstkonto werden automatisch in die Vorschau eingefügt, sofern Sie im Vorschaubefehl keine neuen Werte angeben.

Nachdem Sie eine Vorabversion erstellt haben, können Sie die Ergebnisse exportieren und ansehen, um den Plan für die Bereitstellung zu prüfen.

Nächste Schritte