Membuat dan menerapkan kebijakan penempatan spread ke VM

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

Kebijakan penempatan spread 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 terdistribusi dan direplikasi berskala besar 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 sampel 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 Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI. Setelah penginstalan, 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

Agar mendapatkan izin yang Anda perlukan untuk membuat dan menerapkan kebijakan penempatan spread 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 spread 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 spread 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 di template instance
    • Untuk menetapkan jaringan lama ke VM: compute.networks.use pada project
    • Untuk menentukan alamat IP statis untuk VM: compute.addresses.use di project
    • Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan lama: compute.networks.useExternalIp di project
    • Untuk menentukan subnet bagi VM: compute.subnetworks.use pada project atau pada subnet yang dipilih
    • Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC: compute.subnetworks.useExternalIp di project atau di subnet yang dipilih
    • Untuk menetapkan metadata instance VM untuk VM: compute.instances.setMetadata di project
    • Untuk menyetel tag untuk VM: compute.instances.setTags di VM
    • Untuk menyetel label VM: compute.instances.setLabels di VM
    • Untuk menyetel 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 spread

Kecuali jika Anda ingin menguji penerapan kebijakan penempatan spread ke instance, Google Cloud sebaiknya buat kebijakan penempatan spread dengan dua atau lebih domain ketersediaan. Tindakan ini mengurangi risiko semua instance terpengaruh oleh satu kesalahan hardware. Untuk mengetahui informasi selengkapnya, lihat Tentang kebijakan penempatan spread.

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

gcloud

Untuk membuat kebijakan penempatan spread, 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 spread.

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

  • REGION: region tempat membuat kebijakan penempatan.

REST

Untuk membuat kebijakan penempatan spread, 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 kebijakan penempatan akan dibuat.

  • REGION: region tempat membuat kebijakan penempatan.

  • POLICY_NAME: nama kebijakan penempatan spread.

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

Menerapkan kebijakan penempatan spread

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

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

Setelah menerapkan kebijakan penempatan spread 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 spread ke VM yang ada, pertimbangkan hal berikut:

  • Jika kebijakan penempatan spread 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 spread 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, terapkan kebijakan penempatan ke VM dengan memperbarui propertinya. Saat memperbarui properti VM, pastikan untuk menyertakan kolom resourcePolicies dan scheduling.availabilityDomain.

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

gcloud

Untuk menerapkan kebijakan penempatan spread 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 spread 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 spread dan VM berada.

  • ZONE: zona tempat VM berada.

  • VM_NAME: nama VM yang ada.

  • REGION: region tempat kebijakan penempatan spread berada.

  • POLICY_NAME: nama kebijakan penempatan spread yang ada.

Menerapkan kebijakan saat membuat VM

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

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

gcloud

Untuk membuat VM yang menentukan kebijakan penempatan spread, 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 jumlah domain ketersediaan untuk menempatkan VM Anda. Nilainya harus antara 1 dan jumlah domain yang ditentukan dalam kebijakan penempatan spread. Untuk memverifikasi jumlah domain dalam kebijakan penempatan sebaran, lihat detail kebijakan penempatan.

REST

Untuk membuat VM yang menentukan kebijakan penempatan spread, 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 spread berada.

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

  • VM_NAME: nama VM yang akan dibuat.

  • MACHINE_TYPE: jenis mesin untuk VM.

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

  • IMAGE: tentukan salah satu dari berikut ini:

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

    • Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Tindakan ini menentukan image OS 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 spread berada.

  • POLICY_NAME: nama kebijakan penempatan spread yang ada.

Atau, untuk menentukan domain ketersediaan tempat VM akan dibuat, sertakan kolom availabilityDomain di 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 jumlah domain ketersediaan untuk menempatkan VM Anda. Nilainya harus antara 1 dan jumlah domain yang ditentukan dalam kebijakan penempatan spread. Untuk memverifikasi jumlah domain dalam kebijakan penempatan sebaran, 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 spread, pastikan hal berikut:

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

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

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

gcloud

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

Misalnya, untuk membuat instance secara massal dalam 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 dimulai 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 jumlah domain ketersediaan untuk menempatkan VM Anda. Nilainya harus antara 1 dan jumlah domain yang ditentukan dalam kebijakan penempatan spread. Untuk memverifikasi jumlah domain dalam kebijakan penempatan sebaran, lihat detail kebijakan penempatan.

REST

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

Misalnya, untuk membuat instance secara massal dalam 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 spread 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 dimulai dengan vm-1, vm-2, dan berlanjut hingga jumlah instance yang ditentukan oleh COUNT.

  • MACHINE_TYPE: jenis mesin untuk instance.

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

  • IMAGE: tentukan salah satu dari berikut ini:

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

    • Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Tindakan ini menentukan image OS 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 di 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 jumlah domain ketersediaan untuk menempatkan VM Anda. Nilainya harus antara 1 dan jumlah domain yang ditentukan dalam kebijakan penempatan spread. Untuk memverifikasi jumlah domain dalam kebijakan penempatan sebaran, 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 membuat template instance yang menentukan kebijakan penempatan spread, pertimbangkan hal berikut:

  • Jika Anda ingin membuat template instance regional, template dan kebijakan penempatan spread 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 kesalahan hardware yang memengaruhi semua instance Anda.

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

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

Konsol

  1. Di konsol Google Cloud , buka halaman Instance templates.

    Buka Instance templates

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

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

  4. Di bagian Konfigurasi mesin, 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 spread, 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 instance akan dibuat, 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 jumlah 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 sebaran, lihat detail kebijakan penempatan.

REST

Untuk membuat template instance yang menentukan kebijakan penempatan spread, 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 spread berada.

  • INSTANCE_TEMPLATE_NAME: nama template instance.

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

  • IMAGE: tentukan salah satu dari berikut ini:

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

    • Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Tindakan ini menentukan image OS 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 di 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 jumlah 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 sebaran, lihat detail kebijakan penempatan.

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

Apa langkah selanjutnya?