Konfigurationsvorschau ansehen

Auf dieser Seite wird beschrieben, wie Sie eine Konfigurationsdatei in der Vorschau anzeigen, bevor Sie eine Bereitstellung erstellen. Weitere Informationen zu Konfigurationen finden Sie unter Konfigurationsübersicht.

Nachdem Sie eine Konfigurationsdatei geschrieben haben, können Sie eine Vorschau der Konfiguration anzeigen, bevor Sie eine Bereitstellung erstellen. Bei der Vorschau auf eine Konfiguration können Sie die Ressourcen anzeigen, die von Deployment Manager erstellt werden, ohne jedoch tatsächlich bereits Ressourcen zu instanziieren. Der Deployment Manager-Dienst zeigt die Konfigurationsvorschau folgendermaßen an:

  1. Die vollständige Konfiguration, einschließlich aller Vorlagen, expandiert.
  2. Eine Bereitstellung und "shell"-Ressourcen erstellt.

Sie können Ihre Konfiguration mit dem Abfrageparameter preview anzeigen, wenn Sie eine insert()-Anfrage stellen.

Hinweis

Vorschau auf eine neue Konfiguration

Vorschau einer Konfiguration mit der Google Cloud CLI anzeigen oder einen eine direkte Anfrage an die API senden.

gcloud

Wenn Sie die Google Cloud CLI nutzen, führen Sie den Unterbefehl create aus. mit dem Flag --preview:

gcloud deployment-manager deployments create example-config --config configuration-file.yaml \
     --preview

Der Server gibt eine Liste der Ressourcen zurück, deren Status IN_PREVIEW für Ihre Vorschau bereit ist:

The fingerprint of the deployment is ulPDrJON8E5ySHKC5fcukw==
Waiting for create [operation-1492785372594-54dae2ddbff50-58d45d53-12d483cf]...done.
Create operation operation-1492785372594-54dae2ddbff50-58d45d53-12d483cf completed successfully.
NAME                      TYPE                 STATE       ERRORS  INTENT
datadisk-example  compute.v1.disk      IN_PREVIEW  []      CREATE_OR_ACQUIRE
vm-example        compute.v1.instance  IN_PREVIEW  []      CREATE_OR_ACQUIRE

API

Verwenden Sie in der API die insert()-Methode mit einem Anfragetext, der die Felder target und name und den Abfrageparameter preview=true enthält. Stellen Sie Ihre Konfiguration im Feld target bereit.

Die folgende API-Anfrage zeigt beispielsweise eine einfache Vorlage an:

POST https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments?preview=true

{
 "name": "example-config",
 "target": {
  "config": {
    "content":  "resources:\n- name: vm-created-by-cloud-config\n  type: compute.v1.instance\n  properties:\n    zone: us-central1-a\n    machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/n1-standard-1\n    disks:\n    - deviceName: boot\n      type: PERSISTENT\n      boot: true\n      autoDelete: true\n      initializeParams:\n        diskName: disk-created-by-cloud-config\n        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20140619\n    networkInterfaces:\n    networkInterfaces:\n    - network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default"
   }
  }
}

Wenn sich eine Bereitstellung im Vorschaumodus befindet, können Sie die Bereitstellung auf drei Arten weiterführen:

Mehrere Vorschauen ausführen

Wenn Sie Ihre Konfiguration ändern und eine weitere Vorschau durchführen möchten, verwenden Sie den update-Befehl mit dem Flag --preview:

gcloud deployment-manager deployments update example-config \
    --config new-config.yaml --preview

Erstellen Sie in der API eine PUT()-Anfrage an eine vorhandene Bereitstellung und geben Sie den Abfrageparameter preview=true an. Der Anfragetext muss die Felder intent, target und name enthalten. Die folgende API-Anfrage liefert eine Vorschau einer einfachen Aktualisierung:

PUT https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments/example-config?preview=true

{
 "target": {
  "config": {
   "content": "resources:\n- name: vm-created-by-cloud-config\n  type: compute.v1.instance\n  properties:\n    zone: us-central1-a\n    machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/n1-standard-1\n    disks:\n    - deviceName: boot\n      type: PERSISTENT\n      boot: true\n      autoDelete: true\n      initializeParams:\n        diskName: disk-created-by-cloud-config\n        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20140619\n    networkInterfaces:\n    - network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default"
  }
 },
 "name": "example-config"
}

Vorschau bereitstellen oder abbrechen

Nachdem Sie die Vorschau für eine Bereitstellung aufgerufen haben, können Sie mit der Bereitstellung fortfahren und eine Aktualisierung sowie ein Commit für die Konfiguration ausführen. Angenommen, es wird eine Bereitstellung namens "example-config" im Vorschaumodus angezeigt. Sie können sofort mit der Bereitstellung fortfahren, indem Sie den folgenden Befehl ausführen:

gcloud deployment-manager deployments update example-config

Deployment Manager verwendet die letzte Vorschaukonfiguration, um eine Bereitstellung zu erstellen.

Wenn Sie nicht mit der Konfiguration fortfahren möchten, können Sie alternativ die Vorschau abbrechen und dann die Bereitstellung löschen:

gcloud deployment-manager deployments cancel-preview example-config

Während der Bereitstellung im Vorschaumodus können Sie nicht mit einer anderen Konfiguration fortfahren. Nehmen wir beispielsweise an, Sie haben eine Bereitstellung mit dem Namen example-config im Vorschaumodus unter Verwendung einer Konfiguration namens vm.yaml. Sie möchten eine neue Konfiguration mit dem Namen two_vms.yaml für dieselbe Bereitstellung bereitstellen und die Vorschau überspringen. So lange example-config sich noch im Vorschaumodus befindet, können Sie keine neue Konfiguration bereitstellen. Beenden Sie die Vorschau und aktualisieren Sie die Bereitstellung mit der neuen Konfiguration.

Nächste Schritte