Membuat dan menerapkan kebijakan penempatan spread ke VM

Dokumen ini menjelaskan cara meningkatkan keandalan instance virtual machine (VM) dengan membuat dan menerapkan kebijakan penempatan tersebar pada instance tersebut. Untuk mempelajari lebih lanjut kebijakan penempatan, termasuk batasan dan harganya, lihat Ringkasan kebijakan penempatan.

Kebijakan penempatan tersebar menentukan bahwa instance Anda harus didistribusikan di berbagai domain ketersediaan. Distribusi ini membantu mengurangi gangguan khusus lokasi, seperti error hardware, dan berguna saat menjalankan workload berskala besar, terdistribusi, dan direplikasi seperti Hadoop Distributed File System (HDFS), Cassandra, atau Kafka.

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan konsol Google Cloud untuk mengakses layanan dan API Google Cloud , Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI. Setelah penginstalan, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  • Tetapkan region dan zona default.
  • REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat dan menerapkan kebijakan penempatan tersebar ke instance, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk membuat dan menerapkan kebijakan penempatan tersebar ke instance. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat dan menerapkan kebijakan penempatan tersebar ke instance:

  • Untuk membuat kebijakan penempatan: compute.resourcePolicies.create pada project
  • Untuk menerapkan kebijakan penempatan ke instance yang ada: compute.instances.addResourcePolicies pada project
  • Untuk membuat instance:
    • compute.instances.create pada project
    • Untuk menggunakan image kustom guna membuat VM: compute.images.useReadOnly pada image
    • Untuk menggunakan snapshot guna membuat VM: compute.snapshots.useReadOnly pada snapshot
    • Untuk menggunakan template instance guna membuat VM: compute.instanceTemplates.useReadOnly pada template instance
    • Untuk menetapkan jaringan lama ke VM: compute.networks.use pada project
    • Untuk menentukan alamat IP statis bagi VM: compute.addresses.use pada project
    • Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan lama: compute.networks.useExternalIp pada project
    • Untuk menentukan subnet bagi VM: compute.subnetworks.use di project atau di subnet yang dipilih
    • Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC: compute.subnetworks.useExternalIp pada project atau pada subnet yang dipilih
    • Untuk menetapkan metadata instance VM untuk VM: compute.instances.setMetadata di project
    • Untuk menetapkan tag bagi VM: compute.instances.setTags di VM
    • Untuk menetapkan label bagi VM: compute.instances.setLabels di VM
    • Untuk menetapkan akun layanan yang akan digunakan VM: compute.instances.setServiceAccount di VM
    • Untuk membuat disk baru untuk VM: compute.disks.create di project
    • Untuk memasang disk yang ada dalam mode hanya baca atau baca-tulis: compute.disks.use pada disk
    • Untuk memasang disk yang ada dalam mode hanya baca: compute.disks.useReadOnly pada disk
  • Untuk membuat template instance: compute.instanceTemplates.create pada project
  • Untuk membuat grup instance terkelola (MIG): compute.instanceGroupManagers.create pada project

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Membuat kebijakan penempatan tersebar

Kecuali jika Anda ingin menguji penerapan kebijakan penempatan tersebar ke instance, Google Cloud merekomendasikan pembuatan kebijakan penempatan tersebar dengan dua atau beberapa domain ketersediaan. Hal ini mengurangi risiko semua instance terpengaruh oleh satu error hardware. Untuk mengetahui informasi selengkapnya, lihat Tentang kebijakan penempatan tersebar.

Untuk membuat kebijakan penempatan tersebar, pilih salah satu opsi berikut:

gcloud

Untuk membuat kebijakan penempatan tersebar, gunakan perintah gcloud compute resource-policies create group-placement dengan flag --availability-domain-count.

gcloud compute resource-policies create group-placement POLICY_NAME \
    --availability-domain-count=DOMAIN_COUNT \
    --region=REGION

Ganti kode berikut:

  • POLICY_NAME: nama kebijakan penempatan tersebar.

  • DOMAIN_COUNT: jumlah domain ketersediaan yang berbeda untuk menempatkan instance Anda. Nilainya harus di antara 1 dan 8.

  • REGION: region tempat membuat kebijakan penempatan.

REST

Untuk membuat kebijakan penempatan tersebar, buat permintaan POST ke metode resourcePolicies.insert. Dalam isi permintaan, sertakan kolom availabilityDomainCount.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies

{
  "name": "POLICY_NAME",
  "groupPlacementPolicy": {
    "availabilityDomainCount": DOMAIN_COUNT
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat membuat kebijakan penempatan.

  • REGION: region tempat membuat kebijakan penempatan.

  • POLICY_NAME: nama kebijakan penempatan tersebar.

  • DOMAIN_COUNT: jumlah domain ketersediaan yang berbeda untuk menempatkan instance Anda. Nilainya harus di antara 1 dan 8.

Menerapkan kebijakan penempatan tersebar

Anda dapat menerapkan kebijakan penempatan tersebar ke VM atau MIG yang ada, atau saat membuat instance, template instance, atau MIG.

Untuk menerapkan kebijakan penempatan tersebar ke resource Compute Engine, pilih salah satu metode berikut:

Setelah menerapkan kebijakan penempatan tersebar ke VM, Anda dapat memverifikasi domain ketersediaan tempat VM berada dengan melihat detail VM dan memeriksa nilai kolom availabilityDomain.

Menerapkan kebijakan ke VM yang ada

Sebelum menerapkan kebijakan penempatan tersebar ke VM yang ada, pertimbangkan hal berikut:

  • Jika kebijakan penempatan tersebar Anda menentukan beberapa domain ketersediaan, Anda dapat menerapkan kebijakan tersebut ke VM tanpa menghentikan VM. Namun, VM mungkin perlu dipindahkan ke domain ketersediaan yang berbeda. Selama proses ini, Compute Engine akan menghentikan atau memigrasikan VM secara langsung berdasarkan kebijakan pemeliharaan host-nya.

  • VM dan kebijakan penempatan tersebar harus berada di region yang sama. Misalnya, jika kebijakan penempatan berada di region us-central1, VM harus berada di zona di us-central1. Jika Anda perlu memigrasikan VM ke region lain, lihat Memindahkan VM antar-zona atau antar-region.

Jika Anda ingin menentukan domain ketersediaan tempat VM akan ditempatkan, perbarui properti VM untuk menerapkan kebijakan penempatan ke VM. Dalam permintaan update, sertakan kolom resourcePolicies dan scheduling.availabilityDomain, serta tentukan REFRESH sebagai tindakan paling mengganggu yang diizinkan. Jika nanti Anda mengubah kolom scheduling.availabilityDomain untuk VM yang sudah memiliki kebijakan penempatan tersebar, Anda harus menentukan RESTART sebagai tindakan yang paling mengganggu yang diizinkan.

Untuk menerapkan kebijakan penempatan tersebar ke VM yang ada, pilih salah satu opsi berikut:

gcloud

Untuk menerapkan kebijakan penempatan tersebar ke VM yang ada, gunakan perintah gcloud compute instances add-resource-policies.

gcloud compute instances add-resource-policies VM_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Ganti kode berikut:

  • VM_NAME: nama VM yang ada.

  • POLICY_NAME: nama kebijakan penempatan spread yang ada.

  • ZONE: zona tempat VM berada.

REST

Untuk menerapkan kebijakan penempatan tersebar ke VM yang ada, buat permintaan POST ke metode instances.addResourcePolicies.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/addResourcePolicies

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat kebijakan penempatan tersebar dan VM berada.

  • ZONE: zona tempat VM berada.

  • VM_NAME: nama VM yang ada.

  • REGION: region tempat kebijakan penempatan tersebar berada.

  • POLICY_NAME: nama kebijakan penempatan spread yang ada.

Menerapkan kebijakan saat membuat VM

Anda hanya dapat membuat VM yang menentukan kebijakan penempatan tersebar di region yang sama dengan kebijakan penempatan.

Untuk membuat VM yang menentukan kebijakan penempatan tersebar, pilih salah satu opsi berikut:

gcloud

Untuk membuat VM yang menentukan kebijakan penempatan tersebar, gunakan perintah gcloud compute instances create dengan flag --resource-policies.

gcloud compute instances create VM_NAME \
    --machine-type=MACHINE_TYPE \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Ganti kode berikut:

  • VM_NAME: nama VM yang akan dibuat.

  • MACHINE_TYPE: jenis mesin untuk VM.

  • POLICY_NAME: nama kebijakan penempatan spread yang ada.

  • ZONE: zona tempat untuk membuat VM.

Secara opsional, untuk menentukan domain ketersediaan tempat VM akan dibuat, sertakan flag --availability-domain.

gcloud compute instances create VM_NAME \
    --availability-domain=DOMAIN_NUMBER \
    --machine-type=MACHINE_TYPE \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Ganti DOMAIN_NUMBER dengan nomor domain ketersediaan untuk menempatkan VM Anda. Nilainya harus antara 1 dan jumlah domain yang ditentukan dalam kebijakan penempatan tersebar. Untuk memverifikasi jumlah domain dalam kebijakan penempatan tersebar, lihat detail kebijakan penempatan.

REST

Untuk membuat VM yang menentukan kebijakan penempatan tersebar, buat permintaan POST ke metode instances.insert. Dalam isi permintaan, sertakan kolom resourcePolicies.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "VM_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat kebijakan penempatan tersebar berada.

  • ZONE: zona tempat membuat VM dan tempat jenis mesin berada. Anda hanya dapat menentukan zona dalam region kebijakan penempatan tersebar.

  • VM_NAME: nama VM yang akan dibuat.

  • MACHINE_TYPE: jenis mesin untuk VM.

  • IMAGE_PROJECT: project image yang berisi image—misalnya, debian-cloud. Untuk mengetahui informasi selengkapnya tentang project image yang didukung, lihat Image publik.

  • IMAGE: menentukan salah satu dari hal berikut:

    • Versi tertentu dari OS image—misalnya, debian-12-bookworm-v20240617.

    • Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Tindakan ini menentukan OS image terbaru yang masih digunakan. Misalnya, jika Anda menentukan family/debian-12, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang cara menggunakan kelompok image, lihat Praktik terbaik kelompok image.

  • REGION: region tempat kebijakan penempatan tersebar berada.

  • POLICY_NAME: nama kebijakan penempatan spread yang ada.

Atau, untuk menentukan domain ketersediaan tempat VM akan dibuat, sertakan kolom availabilityDomain dalam isi permintaan.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "VM_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ],
  "scheduling": {
    "availabilityDomain": DOMAIN_NUMBER
  }
}

Ganti DOMAIN_NUMBER dengan nomor domain ketersediaan untuk menempatkan VM Anda. Nilainya harus antara 1 dan jumlah domain yang ditentukan dalam kebijakan penempatan tersebar. Untuk memverifikasi jumlah domain dalam kebijakan penempatan tersebar, lihat detail kebijakan penempatan.

Untuk mengetahui informasi selengkapnya tentang opsi konfigurasi untuk membuat VM, lihat Membuat dan memulai instance VM.

Menerapkan kebijakan saat membuat instance secara massal

Sebelum membuat instance secara massal yang menentukan kebijakan penempatan tersebar, pastikan hal berikut:

  • Anda hanya dapat membuat instance secara massal yang menentukan kebijakan penempatan tersebar di region yang sama dengan kebijakan penempatan.

  • Saat membuat instance secara massal dengan kebijakan penempatan tersebar, Anda dapat menentukan domain ketersediaan tempat instance akan dibuat. Hindari membuat semua instance Anda dalam satu domain. Jika tidak, Anda tidak akan mengurangi risiko satu error hardware yang memengaruhi semua instance Anda.

Untuk membuat instance secara massal yang menentukan kebijakan penempatan tersebar, pilih salah satu opsi berikut:

gcloud

Untuk membuat instance secara massal yang menentukan kebijakan penempatan tersebar, gunakan perintah gcloud compute instances bulk create dengan flag --resource-policies.

Misalnya, untuk membuat instance secara massal di satu zona dan menentukan pola nama untuk instance, jalankan perintah berikut:

gcloud compute instances bulk create \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --name-pattern=NAME_PATTERN \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Ganti kode berikut:

  • COUNT: jumlah instance yang akan dibuat.

  • MACHINE_TYPE: jenis mesin untuk instance.

  • NAME_PATTERN: pola nama untuk instance. Untuk mengganti urutan angka dalam nama VM, gunakan urutan karakter hash (#). Misalnya, menggunakan vm-# untuk pola nama akan menghasilkan instance dengan nama yang diawali dengan vm-1, vm-2, dan berlanjut hingga jumlah instance yang ditentukan oleh COUNT.

  • POLICY_NAME: nama kebijakan penempatan spread yang ada.

  • ZONE: zona tempat membuat instance secara massal.

Secara opsional, untuk menentukan domain ketersediaan tempat membuat instance secara massal, sertakan flag --availability-domain.

gcloud compute instances bulk create \
    --availability-domain=DOMAIN_NUMBER \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --name-pattern=NAME_PATTERN \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Ganti DOMAIN_NUMBER dengan nomor domain ketersediaan untuk menempatkan VM Anda. Nilainya harus antara 1 dan jumlah domain yang ditentukan dalam kebijakan penempatan tersebar. Untuk memverifikasi jumlah domain dalam kebijakan penempatan tersebar, lihat detail kebijakan penempatan.

REST

Untuk membuat instance secara massal yang menentukan kebijakan penempatan tersebar, buat POST ke metode instances.bulkInsert. Dalam isi permintaan, sertakan kolom resourcePolicies.

Misalnya, untuk membuat instance secara massal di satu zona dan menentukan pola nama untuk instance, buat permintaan POST sebagai berikut:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": "COUNT",
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "resourcePolicies": [
      "POLICY_NAME"
    ]
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat kebijakan penempatan tersebar berada.

  • ZONE: zona tempat membuat instance secara massal.

  • COUNT: jumlah instance yang akan dibuat.

  • NAME_PATTERN: pola nama untuk instance. Untuk mengganti urutan angka dalam nama VM, gunakan urutan karakter hash (#). Misalnya, menggunakan vm-# untuk pola nama akan menghasilkan instance dengan nama yang diawali dengan vm-1, vm-2, dan berlanjut hingga jumlah instance yang ditentukan oleh COUNT.

  • MACHINE_TYPE: jenis mesin untuk instance.

  • IMAGE_PROJECT: project image yang berisi image—misalnya, debian-cloud. Untuk mengetahui informasi selengkapnya tentang project image yang didukung, lihat Image publik.

  • IMAGE: menentukan salah satu dari hal berikut:

    • Versi tertentu dari OS image—misalnya, debian-12-bookworm-v20240617.

    • Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Tindakan ini menentukan OS image terbaru yang masih digunakan. Misalnya, jika Anda menentukan family/debian-12, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang cara menggunakan kelompok image, lihat Praktik terbaik kelompok image.

  • POLICY_NAME: nama kebijakan penempatan spread yang ada.

Secara opsional, untuk menentukan domain ketersediaan tempat membuat instance secara massal, sertakan kolom availabilityDomain dalam isi permintaan.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": "COUNT",
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "resourcePolicies": [
      "POLICY_NAME"
    ],
    "scheduling": {
      "availabilityDomain": DOMAIN_NUMBER
    }
  }
}

Ganti DOMAIN_NUMBER dengan nomor domain ketersediaan untuk menempatkan VM Anda. Nilainya harus antara 1 dan jumlah domain yang ditentukan dalam kebijakan penempatan tersebar. Untuk memverifikasi jumlah domain dalam kebijakan penempatan tersebar, lihat detail kebijakan penempatan.

Untuk mengetahui informasi selengkapnya tentang opsi konfigurasi untuk membuat instance secara massal, lihat Membuat instance secara massal.

Menerapkan kebijakan saat membuat template instance

Sebelum Anda membuat template instance yang menentukan kebijakan penempatan tersebar, pertimbangkan hal berikut:

  • Jika Anda ingin membuat template instance regional, template dan kebijakan penempatan tersebar harus berada di region yang sama. Jika tidak, pembuatan template instance akan gagal.

  • Hindari membuat semua instance dalam satu domain ketersediaan. Jika tidak, Anda tidak akan mengurangi risiko satu error hardware yang memengaruhi semua instance Anda.

Setelah membuat template instance yang menentukan kebijakan penempatan tersebar, Anda dapat menggunakan template tersebut untuk melakukan hal berikut:

Untuk membuat template instance regional dan kebijakan penempatan tersebar baru dengan delapan domain ketersediaan, gunakan konsol Google Cloud . Untuk membuat template instance global atau regional, dan menentukan kebijakan penempatan tersebar yang ada, gunakan gcloud CLI atau REST API:

Konsol

  1. Di konsol Google Cloud , buka halaman template instance.

    Buka halaman Template instance

  2. Klik Buat template instance . Halaman Create an instance template akan muncul.

  3. Di kolom Region, tentukan region tempat Anda ingin membuat kebijakan penempatan tersebar dan template instance.

  4. Di bagian Machine configuration, tentukan seri dan jenis mesin.

  5. Di bagian Placement policy, dalam daftar Placement policy, pilih Spread.

  6. Klik Create.

gcloud

Untuk membuat template instance yang menentukan kebijakan penempatan tersebar, gunakan perintah gcloud compute instance-templates create dengan flag --resource-policies.

Misalnya, untuk membuat template instance global yang menentukan kebijakan penempatan spread, jalankan perintah berikut:

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --machine-type=MACHINE_TYPE \
    --resource-policies=POLICY_NAME

Ganti kode berikut:

  • INSTANCE_TEMPLATE_NAME: nama template instance.

  • MACHINE_TYPE: jenis mesin untuk instance yang dibuat menggunakan template instance.

  • POLICY_NAME: nama kebijakan penempatan spread yang ada.

Secara opsional, untuk menentukan domain ketersediaan tempat membuat instance, sertakan flag --availability-domain.

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --availability-domain=DOMAIN_NUMBER  \
    --machine-type=MACHINE_TYPE \
    --resource-policies=POLICY_NAME

Ganti DOMAIN_NUMBER dengan nomor domain ketersediaan untuk membuat instance Anda. Nilai harus antara 1 dan jumlah domain yang ditentukan dalam kebijakan penempatan. Untuk memverifikasi jumlah domain dalam kebijakan penempatan tersebar, lihat detail kebijakan penempatan.

REST

Untuk membuat template instance yang menentukan kebijakan penempatan tersebar, buat permintaan POST ke salah satu metode berikut:

Dalam isi permintaan, tentukan kolom resourcePolicies.

Misalnya, untuk membuat template instance global yang menentukan kebijakan penempatan spread, buat permintaan POST sebagai berikut:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "resourcePolicies": [
      "POLICY_NAME"
    ]
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat kebijakan penempatan tersebar berada.

  • INSTANCE_TEMPLATE_NAME: nama template instance.

  • IMAGE_PROJECT: project image yang berisi image—misalnya, debian-cloud. Untuk mengetahui informasi selengkapnya tentang project image yang didukung, lihat Image publik.

  • IMAGE: menentukan salah satu dari hal berikut:

    • Versi tertentu dari OS image—misalnya, debian-12-bookworm-v20240617.

    • Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Tindakan ini menentukan OS image terbaru yang masih digunakan. Misalnya, jika Anda menentukan family/debian-12, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang cara menggunakan kelompok image, lihat Praktik terbaik kelompok image.

  • MACHINE_TYPE: jenis mesin untuk instance yang dibuat menggunakan template instance.

  • POLICY_NAME: nama kebijakan penempatan spread yang ada.

Secara opsional, untuk menentukan domain ketersediaan tempat instance akan dibuat, sertakan kolom availabilityDomain dalam isi permintaan.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "resourcePolicies": [
      "POLICY_NAME"
    ],
    "scheduling": {
      "availabilityDomain": DOMAIN_NUMBER
    }
  }
}

Ganti DOMAIN_NUMBER dengan nomor domain ketersediaan untuk membuat instance Anda. Nilai harus antara 1 dan jumlah domain yang ditentukan dalam kebijakan penempatan. Untuk memverifikasi jumlah domain dalam kebijakan penempatan tersebar, lihat detail kebijakan penempatan.

Untuk mengetahui informasi selengkapnya tentang opsi konfigurasi untuk membuat template instance, lihat Membuat template instance.

Apa langkah selanjutnya?