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 oleh Deployment Manager tetapi tidak benar-benar membuat instance resource sebenarnya. Layanan Deployment Manager mempratinjau konfigurasi dengan:

  1. Memperluas konfigurasi lengkap, termasuk template apa pun.
  2. Membuat deployment dan resource "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 sub-perintah create dengan tanda --preview:

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

Server akan menampilkan daftar resource dengan status IN_PREVIEW yang dapat 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 mempratinjau 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 menjalankan pratinjau lainnya, 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 mempratinjau update 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, anggap Anda memiliki deployment bernama example-config yang saat ini berada dalam mode pratinjau. Anda dapat melanjutkan deployment dengan menjalankan perintah berikut:

gcloud deployment-manager deployments update example-config

Deployment Manager menggunakan konfigurasi yang terakhir dipratinjau 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, 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