Membuat Deployment menggunakan gcloud atau API

Halaman ini menjelaskan cara membuat deployment. Deployment adalah instance dari kumpulan resource yang ditentukan dalam konfigurasi. Anda memberikan konfigurasi yang valid dalam permintaan untuk membuat deployment. Deployment dapat berisi sejumlah resource, di berbagai layanan Google Cloud. Saat Anda membuat deployment, Deployment Manager akan membuat semua resource yang dijelaskan di Google Cloud API masing-masing.

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.
• Buat konfigurasi.

Membuat deployment

Saat membuat deployment, Anda membuat Resource deployment yang berisi kumpulan resource. Setiap resource ditentukan secara eksplisit dalam konfigurasi yang Anda berikan dalam permintaan.

gcloud

Dengan Google Cloud CLI, gunakan perintah deployments create:

gcloud deployment-manager deployments create my-first-deployment \
    --config vm.yaml

Flag --config adalah jalur relatif ke file konfigurasi YAML Anda.

Secara default, jika konfigurasi Anda menyertakan resource yang sudah ada dalam project, resource tersebut akan diperoleh oleh deployment, dan dapat dikelola menggunakan deployment. Jika tidak ingin memperoleh resource, Anda harus menggunakan opsi --create-policy, seperti dalam perintah gcloud beta berikut:

gcloud beta deployment-manager deployments create my-first-deployment \
    --config vm.yaml --create-policy CREATE

Untuk informasi tentang kebijakan yang dapat Anda gunakan saat membuat deployment, lihat Menetapkan kebijakan untuk membuat resource.

Jika deployment berhasil dibuat, Anda bisa mendapatkan deskripsi deployment:

gcloud deployment-manager deployments describe my-first-deployment

API

Di API, buat permintaan insert() dengan konfigurasi yang diberikan secara inline, dalam isi permintaan:

POST https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments

{
 "name": "example-config-with-templates",
 "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-v20151104\n    networkInterfaces:\n    - network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default\n"
  }
 }
}

Jika mengimpor template, Anda juga harus memberikan template tersebut sebagai bagian dari isi permintaan. Misalnya, permintaan API berikut memiliki target yang mengimpor satu template, bernama vm_template.jinja:

POST https://www-www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments

{
 "name": "my-example-config-with-templates-2",
 "target": {
  "config": {
    "content": "imports:\n- path: vm_template.jinja\n\nresources:\n- name: my-vm\n  type: vm_template.jinja"
  },
  "imports": [
   {
    "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-v20151104\n    networkInterfaces:\n    - network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default",
    "name": "vm_template.jinja"
   }
  ]
 }
}

Catatan: Saat Anda menggunakan API untuk membuat deployment, operasi mungkin memerlukan waktu yang cukup lama untuk diselesaikan. Untuk panduan memeriksa status operasi, baca artikel tentang mengelola operasi yang berjalan lama.

Menetapkan kebijakan untuk membuat resource

Beta

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Saat Anda membuat deployment baru, jika resource yang ingin Anda buat sudah ada di project, resource tersebut akan diperoleh oleh deployment. Dalam kasus tersebut, Deployment Manager tidak membuat resource baru. Jika tidak ingin memperoleh resource yang ada, Anda harus menggunakan kebijakan CREATE untuk deployment.

Anda dapat menggunakan kebijakan berikut untuk membuat resource:

• CREATE_OR_ACQUIRE - [Default] Deployment Manager memperoleh resource yang ada dalam project, atau membuat resource jika tidak ada. Untuk mendapatkan resource, Deployment Manager akan memeriksa konfigurasi Anda untuk properti resource yang Anda coba buat. Jika ada resource yang sudah ada dengan properti yang sama, Deployment Manager akan mengakuisisi resource tersebut sebagai bagian dari deployment Anda.

  Properti yang diperiksa Deployment Manager bergantung pada jenis resource yang Anda buat, dan dapat mencakup:

  • name resource
  • type resource
  • zone atau region resource, jika ada

  Properti ini adalah bagian dari URL untuk permintaan API GET untuk resource. Untuk melihat properti yang digunakan Deployment Manager untuk memperoleh resource, lihat dokumentasi API untuk metode GET resource. Misalnya, untuk instance Compute Engine, URL permintaan untuk metode instances.get menyertakan resourceId (name dalam konfigurasi Anda), zone, dan project.

  Catatan: Jika ingin memperoleh resource, Anda harus memberikan semua properti yang diperlukan dari resource tersebut, seolah-olah Anda membuatnya.

• CREATE - Deployment Manager membuat resource yang tidak ada. Jika ada resource dalam konfigurasi Anda yang sudah ada di project, deployment akan gagal.

• ACQUIRE - Deployment Manager mengakuisisi resource yang sudah ada, menggunakan kriteria yang sama dengan CREATE_OR_ACQUIRE.

  Gunakan kebijakan ACQUIRE jika Anda memiliki sejumlah resource yang sudah ada dalam project, dan ingin mengelolanya bersama, sebagai satu deployment.

  Dalam template atau konfigurasi, Anda harus memberikan properti yang diperlukan untuk resource ini seolah-olah Anda membuatnya. Jika salah satu resource dalam konfigurasi Anda tidak ada dalam project, deployment akan gagal.

  Peringatan: Jangan peroleh resource yang sudah menjadi bagian dari deployment lain. Jika Anda melakukannya, setiap perubahan yang Anda buat pada satu deployment dapat menyebabkan perilaku yang tidak terduga pada resource di deployment lainnya.

Mencantumkan deployment

Lihat daftar deployment Anda di Konsol Google Cloud, API, atau Google Cloud CLI.

Konsol

Buka halaman Deployments di konsol Google Cloud.

gcloud

Dengan Google Cloud CLI, gunakan subperintah deployments list:

gcloud deployment-manager deployments list

API

Di API, buat permintaan GET kosong ke koleksi Deployments:

GET https://www.googleapis.com/deploymentmanager/v2beta1/projects/myproject/global/deployments

Langkah selanjutnya

• Tambahkan label ke deployment Anda.
• Perbarui deployment Anda.