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:
- Memperluas konfigurasi lengkap, termasuk template apa pun.
- Membuat resource deployment dan "shell".
Anda dapat melihat pratinjau konfigurasi menggunakan parameter kueri preview
saat
membuat permintaan
insert()
.
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 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:
- Deploy konfigurasi dengan melakukan update.
- Batalkan pratinjau, lalu hapus deployment.
- Perbarui pratinjau.
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
- Pelajari file konfigurasi lebih lanjut.
- Buat update pada deployment setelah Anda men-deploy-nya.