Melihat pratinjau konfigurasi

Halaman ini menjelaskan cara melihat pratinjau file konfigurasi sebelum membuat deployment. Untuk mempelajari konfigurasi lebih lanjut, baca Ringkasan Konfigurasi.

Setelah menulis file konfigurasi, Anda dapat melihat pratinjau konfigurasi sebelum membuat deployment. Dengan melihat pratinjau konfigurasi, Anda dapat melihat resource yang akan dibuat Deployment Manager, tetapi tidak benar-benar membuat instance resource yang sebenarnya. Layanan Deployment Manager melihat pratinjau konfigurasi dengan:

  1. Memperluas konfigurasi lengkap, termasuk template apa pun.
  2. Membuat resource deployment dan "shell".

Anda dapat melihat pratinjau konfigurasi menggunakan parameter kueri preview saat membuat permintaan insert().

Sebelum memulai

Melihat pratinjau konfigurasi baru

Lihat pratinjau konfigurasi menggunakan Google Cloud CLI atau dengan membuat permintaan langsung ke API.

gcloud

Jika Anda menggunakan Google Cloud CLI, gunakan subperintah create dengan flag --preview:

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

Server menampilkan daftar resource yang statusnya IN_PREVIEW untuk Anda tinjau:

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

Di API, gunakan metode insert() dengan isi permintaan yang berisi kolom target dan name serta parameter kueri preview=true. Berikan konfigurasi Anda di kolom target.

Misalnya, permintaan API berikut menampilkan pratinjau template sederhana:

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"
   }
  }
}

Saat deployment berada dalam mode pratinjau, Anda dapat melanjutkan deployment dengan salah satu dari tiga cara berikut:

Melakukan beberapa pratinjau

Jika Anda ingin mengubah konfigurasi dan melakukan pratinjau lain, gunakan perintah update dengan flag --preview:

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

Di API, buat permintaan PUT() dengan deployment yang ada dan berikan parameter kueri preview=true. Isi permintaan harus berisi kolom intent, target, dan name. Misalnya, permintaan API berikut melihat pratinjau pembaruan sederhana:

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"
}

Men-deploy atau membatalkan pratinjau

Setelah melihat pratinjau deployment, Anda dapat melanjutkan deployment dengan melakukan update dan melakukan commit konfigurasi. Misalnya, Anda memiliki deployment bernama example-config yang saat ini dalam mode pratinjau. Anda dapat melanjutkan deployment dengan menjalankan perintah berikut:

gcloud deployment-manager deployments update example-config

Deployment Manager menggunakan konfigurasi pratinjau terakhir untuk membuat deployment.

Atau, jika tidak ingin melanjutkan konfigurasi, Anda dapat membatalkan pratinjau, lalu menghapus deployment:

gcloud deployment-manager deployments cancel-preview example-config

Saat deployment dalam mode pratinjau, Anda tidak dapat melanjutkan dengan konfigurasi lain. Misalnya, Anda memiliki deployment bernama example-config yang berada dalam mode pratinjau menggunakan konfigurasi bernama vm.yaml. Anda memutuskan bahwa Anda ingin men-deploy konfigurasi baru bernama two_vms.yaml ke deployment yang sama, dengan melewati proses pratinjau. Saat example-config masih dalam mode pratinjau, Anda tidak dapat men-deploy konfigurasi baru. Batalkan pratinjau, lalu update deployment dengan konfigurasi baru.

Langkah selanjutnya