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:
- Die vollständige Konfiguration, einschließlich aller Vorlagen, expandiert.
- Eine Bereitstellung und "shell"-Ressourcen erstellt.
Sie können Ihre Konfiguration mit dem Abfrageparameter preview
anzeigen, wenn Sie eine insert()
-Anfrage stellen.
Hinweis
- Wenn Sie die Befehlszeilenbeispiele in dieser Anleitung verwenden möchten, installieren Sie das gcloud-Befehlszeilentool.
- Wenn Sie die API-Beispiele in dieser Anleitung verwenden möchten, richten Sie den API-Zugriff ein.
- Informieren Sie sich, wie eine grundlegende Konfiguration erstellt wird.
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:
- Stellen Sie die Konfiguration bereit, indem Sie eine Aktualisierung ausführen.
- Brechen Sie die Vorschau ab und löschen anschließend die Bereitstellung.
- Aktualisieren Sie die Vorschau.
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
- Mehr über Konfigurationsdateien erfahren
- Mehr erfahren über die Aktualisierung einer erstellten Bereitstellung