Melihat pratinjau konfigurasi

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

Setelah Anda 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 yang sebenarnya. Layanan Deployment Manager melihat pratinjau 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 insert() permintaan.

Sebelum memulai

  • Jika Anda ingin menggunakan contoh command line dalam panduan ini, instal alat command line `gcloud`.
  • Jika Anda ingin menggunakan contoh API dalam panduan ini, siapkan akses API.
  • Pahami cara membuat konfigurasi dasar.

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 flag --preview:

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

Server akan 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 insert() metode dengan isi permintaan yang berisi kolom target dan name serta parameter kueri preview=true. Berikan konfigurasi Anda di kolom target.

Misalnya, permintaan API berikut melihat 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 dalam mode pratinjau, Anda dapat melanjutkan deployment dengan salah satu dari tiga cara:

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 PUT() permintaan 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 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 meng-commit konfigurasi. Misalnya, asumsikan 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 yang terakhir dilihat pratinjaunya 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 konfigurasi lain. Misalnya, asumsikan Anda memiliki deployment bernama example-config yang dalam mode pratinjau menggunakan konfigurasi bernama vm.yaml. Anda memutuskan untuk 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 perbarui deployment dengan konfigurasi baru.

Langkah berikutnya