Menambahkan fleksibilitas instance

Dokumen ini menjelaskan cara menambahkan fleksibilitas instance yang memungkinkan Anda menetapkan beberapa jenis mesin dalam MIG.

Anda dapat menambahkan fleksibilitas instance saat membuat MIG atau dengan mengedit MIG yang sudah ada. Untuk menambahkan fleksibilitas, konfigurasi kebijakan fleksibilitas instance di MIG. Kebijakan ini menggantikan jenis mesin yang ditentukan dalam template instance. Setiap kali membuat instance virtual machine (VM), MIG akan otomatis memilih salah satu jenis mesin yang telah Anda cantumkan dalam kebijakan berdasarkan ketersediaan resource. Anda juga dapat menetapkan peringkat ke daftar jenis mesin untuk menunjukkan preferensi Anda.

Untuk mengetahui cara kerja fleksibilitas instance di MIG, lihat Tentang fleksibilitas instance.

Sebelum memulai

• Pastikan Anda memilih jenis mesin yang didukung di region tempat MIG Anda berada. Untuk melihat jenis mesin di suatu region, lihat Region dan zona yang tersedia.
• 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.

     Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.
• Tetapkan region dan zona default.

Terraform

Untuk menggunakan contoh Terraform di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

1. Instal Google Cloud CLI.

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

3. Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda:

   gcloud auth application-default login

   Anda tidak perlu melakukan langkah ini jika menggunakan Cloud Shell.

   Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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 .

Membuat MIG dengan fleksibilitas instance

Sebelum membuat MIG, Anda harus membuat template instance terlebih dahulu, jika Anda belum memilikinya. Kemudian, Anda dapat membuat MIG dengan fleksibilitas instance untuk mengganti jenis mesin yang ditentukan dalam template instance.

Buat MIG dengan fleksibilitas instance menggunakan salah satu cara berikut:

• Menggunakan beberapa jenis mesin
• Menggunakan beberapa jenis dan preferensi mesin

Membuat MIG dengan beberapa jenis mesin

Konsol

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

   Buka Instance groups

2. Klik Create instance group.

3. Di kolom Nama, masukkan nama untuk MIG.

4. Dalam daftar Instance template, pilih template instance yang ingin Anda gunakan untuk MIG.

5. Sebelum dapat menentukan Jumlah instance dan menambahkan Pilihan instance, Anda harus melakukan hal berikut:

   1. Buka bagian Lokasi di halaman dan tetapkan lokasi sebagai berikut:

      1. Pilih Beberapa zona.

      2. Di drop-down Region dan Zona, pilih region dan zona tempat Anda ingin membuat VM di MIG. Jika Anda memilih template instance regional, region template tersebut akan dipilih secara default.

      3. Di kolom Bentuk distribusi target, pilih Seimbang, Apa pun, atau Zona tunggal apa pun.

         • Jika Anda memilih Seimbang atau Zona tunggal apa pun, di dialog yang terbuka, klik Nonaktifkan redistribusi instance.

         • Jika Anda memilih Semua, pastikan kotak Izinkan redistribusi instance tidak dicentang.

   2. Buka bagian Penskalaan otomatis di halaman dan hapus konfigurasi penskalaan otomatis sebagai berikut:

      1. Di menu drop-down Autoscaling mode, klik Delete autoscaling configuration.

      2. Pada dialog yang terbuka, klik Hapus.

   3. Scroll kembali ke kolom Number of instances.

6. Di kolom Number of instances, tentukan jumlah VM yang Anda inginkan dalam grup.

7. Di bagian Pilihan instance, klik Tambahkan pilihan.

   Jendela Instance selections akan terbuka.

   1. Klik Tambahkan pilihan instance.

   2. Di bagian New instance selection, lakukan tindakan berikut:

      1. Di kolom Name, masukkan nama untuk pilihan instance.

      2. Di bagian Jenis mesin, klik Tambahkan jenis mesin, pilih jenis mesin yang ingin Anda tambahkan dalam pilihan instance, lalu klik Selesai.

         Ulangi langkah ini untuk setiap jenis mesin yang ingin Anda tambahkan ke pilihan instance.

      3. Setelah Anda selesai menambahkan jenis mesin, klik Selesai.

8. Di jendela Instance selections, klik Done.

9. Biarkan kolom lain tetap pada setelan defaultnya atau ubah sesuai kebutuhan.

10. Klik Create.

gcloud

Untuk membuat MIG regional dengan beberapa jenis mesin, gunakan perintah instance-groups managed create sebagai berikut:

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --region REGION \
    --size TARGET_SIZE \
    --template INSTANCE_TEMPLATE_URL \
    --target-distribution-shape SHAPE \
    --instance-redistribution-type none \
    --instance-selection-machine-types MACHINE_TYPE,MACHINE_TYPE,...

MIG zona tidak mendukung fleksibilitas instance. Namun, jika Anda ingin membuat MIG dalam satu zona, tetapkan bentuk distribusi target ke any-single-zone. Selain itu, jika Anda menginginkan zona tertentu, gunakan bentuk distribusi any-single-zone dan sertakan flag --zones ZONE.

Ganti kode berikut:

• INSTANCE_GROUP_NAME: nama MIG.
• REGION: region tempat Anda ingin membuat MIG.
• TARGET_SIZE: jumlah VM yang Anda inginkan agar MIG dibuat dan dikelola.
• INSTANCE_TEMPLATE_URL: URL template instance yang ingin Anda gunakan untuk membuat instance di MIG. URL dapat berisi ID atau nama template instance. Tentukan salah satu nilai berikut:
  • Untuk template instance regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
  • Untuk template instance global: INSTANCE_TEMPLATE_ID
• SHAPE: bentuk distribusi target. Nilainya dapat berupa balanced, any, atau any-single-zone.
• MACHINE_TYPE: jenis mesin yang ingin Anda konfigurasi di MIG—misalnya, n1-standard-16,n2-standard-16,e2-standard-16.

Terraform

Jika Anda belum membuat template instance, yang menentukan properti VM yang Anda inginkan untuk setiap VM di MIG Anda, buat template instance.

Untuk membuat MIG regional dengan beberapa jenis mesin, gunakan resource google_compute_region_instance_group_manager.

resource "google_compute_region_instance_group_manager" "default" {
  name               = "flex-igm"
  base_instance_name = "tf-test-flex-igm"
  region             = "us-central1"

  target_size                      = 3
  distribution_policy_target_shape = "ANY_SINGLE_ZONE"

  version {
    instance_template = google_compute_instance_template.default.id
  }

  instance_flexibility_policy {
    instance_selections {
      name          = "default-instance-selection"
      machine_types = ["n1-standard-16", "n2-standard-16", "e2-standard-16"]
    }
  }

  update_policy {
    instance_redistribution_type = "NONE"
    type                         = "OPPORTUNISTIC"
    minimal_action               = "REPLACE"
    max_surge_fixed              = 0
    max_unavailable_fixed        = 6
  }
}

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

REST

Untuk membuat MIG regional dengan beberapa jenis mesin, buat permintaan POST ke metode regionInstanceGroupManagers.insert.

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

{
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": TARGET_SIZE,
  "instanceTemplate": "INSTANCE_TEMPLATE_URL",
  "distributionPolicy": {
    "targetShape": "SHAPE"
  },
  "updatePolicy": {
    "instanceRedistributionType": "NONE"
  },
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "INSTANCE_SELECTION": {
        "machineTypes": [
          "MACHINE_TYPE_1",
          "MACHINE_TYPE_2",
          ...
        ]
      }
    }
  }
}

MIG zona tidak mendukung fleksibilitas instance. Namun, jika Anda ingin membuat MIG dalam satu zona, tetapkan bentuk distribusi target ke ANY_SINGLE_ZONE. Selain itu, jika Anda menginginkan zona tertentu, gunakan bentuk distribusi ANY_SINGLE_ZONE dan sertakan kolom distributionPolicy.zones[].zone dalam permintaan.

Ganti kode berikut:

• PROJECT_ID: Project ID Anda.
• REGION: region tempat Anda ingin membuat MIG.
• INSTANCE_GROUP_NAME: nama MIG.
• TARGET_SIZE: jumlah VM yang Anda inginkan agar MIG dibuat dan dikelola.
• INSTANCE_TEMPLATE_URL: URL template instance yang ingin Anda gunakan untuk membuat instance di MIG. URL dapat berisi ID atau nama template instance. Tentukan salah satu nilai berikut:
  • Untuk template instance regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
  • Untuk template instance global: INSTANCE_TEMPLATE_ID
• SHAPE: bentuk distribusi target. Nilainya dapat berupa BALANCED, ANY, atau ANY_SINGLE_ZONE.
• INSTANCE_SELECTION: nama untuk daftar jenis mesin.
• MACHINE_TYPE: jenis mesin yang ingin Anda konfigurasi di MIG—misalnya, "n1-standard-16","n2-standard-16","e2-standard-16".

Membuat MIG dengan beberapa jenis dan preferensi mesin

Konsol

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

   Buka Instance groups

2. Klik Create instance group.

3. Di kolom Nama, masukkan nama untuk MIG.

4. Dalam daftar Instance template, pilih template instance yang ingin Anda gunakan untuk MIG.

5. Sebelum dapat menentukan Jumlah instance dan menambahkan Pilihan instance, Anda harus melakukan hal berikut:

   1. Buka bagian Lokasi di halaman dan tetapkan lokasi sebagai berikut:

      1. Pilih Beberapa zona.

      2. Di drop-down Region dan Zona, pilih region dan zona tempat Anda ingin membuat VM di MIG. Jika Anda memilih template instance regional, region template tersebut akan dipilih secara default.

      3. Di kolom Bentuk distribusi target, pilih Seimbang, Apa pun, atau Zona tunggal apa pun.

         • Jika Anda memilih Seimbang atau Zona tunggal apa pun, di dialog yang terbuka, klik Nonaktifkan redistribusi instance.

         • Jika Anda memilih Semua, pastikan kotak Izinkan redistribusi instance tidak dicentang.

   2. Buka bagian Penskalaan otomatis di halaman dan hapus konfigurasi penskalaan otomatis sebagai berikut:

      1. Di menu drop-down Autoscaling mode, klik Delete autoscaling configuration.

      2. Pada dialog yang terbuka, klik Hapus.

   3. Scroll kembali ke kolom Number of instances.

6. Di kolom Number of instances, tentukan jumlah VM yang Anda inginkan dalam grup.

7. Di bagian Pilihan instance, klik Tambahkan pilihan.

   Jendela Instance selections akan terbuka. Ulangi langkah-langkah berikut untuk setiap pilihan instance yang ingin Anda tambahkan di MIG.

   1. Klik Tambahkan pilihan instance.

   2. Di bagian New instance selection, lakukan tindakan berikut:

      1. Di kolom Name, masukkan nama untuk pilihan instance.

      2. Di kolom Rank, masukkan urutan preferensi di antara pilihan instance yang Anda tambahkan untuk MIG.

      3. Di bagian Jenis mesin, klik Tambahkan jenis mesin, pilih jenis mesin yang ingin Anda tambahkan dalam pilihan instance, lalu klik Selesai.

         Ulangi langkah ini untuk setiap jenis mesin yang ingin Anda tambahkan ke pilihan instance.

      4. Setelah Anda selesai menambahkan jenis mesin, klik Selesai.

8. Setelah Anda selesai menambahkan pilihan instance, klik Selesai.

9. Biarkan kolom lain tetap pada setelan defaultnya atau ubah sesuai kebutuhan.

10. Klik Create.

gcloud

Untuk membuat MIG regional dengan beberapa jenis dan preferensi mesin, gunakan perintah instance-groups managed create.

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --region REGION \
    --size TARGET_SIZE \
    --template INSTANCE_TEMPLATE_URL \
    --target-distribution-shape SHAPE \
    --instance-redistribution-type none \
    --instance-selection "name=INSTANCE_SELECTION_1,machine-type=MACHINE_TYPE_1,machine-type=MACHINE_TYPE_2,rank=RANK_1" \
    --instance-selection "name=INSTANCE_SELECTION_2,machine-type=MACHINE_TYPE_3,machine-type=MACHINE_TYPE_4,rank=RANK_2"

MIG zona tidak mendukung fleksibilitas instance. Namun, jika Anda ingin membuat MIG dalam satu zona, tetapkan bentuk distribusi target ke any-single-zone. Selain itu, jika Anda menginginkan zona tertentu, gunakan bentuk distribusi any-single-zone dan sertakan flag --zones ZONE.

Ganti kode berikut:

• INSTANCE_GROUP_NAME: nama MIG.
• REGION: region tempat Anda ingin membuat MIG.
• TARGET_SIZE: jumlah VM yang ingin Anda buat dan kelola oleh MIG.
• INSTANCE_TEMPLATE_URL: URL template instance yang ingin Anda gunakan untuk membuat instance di MIG. URL dapat berisi ID atau nama template instance. Tentukan salah satu nilai berikut:
  • Untuk template instance regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
  • Untuk template instance global: INSTANCE_TEMPLATE_ID
• SHAPE: bentuk distribusi target. Nilainya dapat berupa balanced, any, atau any-single-zone. Bentuk distribusi target lainnya tidak didukung.
• INSTANCE_SELECTION: nama daftar jenis mesin.
• MACHINE_TYPE: jenis mesin yang ingin Anda konfigurasi di MIG.
• RANK: angka yang menunjukkan urutan preferensi Anda untuk pemilihan instance. Nilai yang lebih rendah berarti preferensi yang lebih tinggi.

Terraform

Jika Anda belum membuat template instance, yang menentukan properti VM yang Anda inginkan untuk setiap VM di MIG Anda, buat template instance.

Untuk membuat MIG regional dengan beberapa jenis dan preferensi mesin, gunakan resource google_compute_region_instance_group_manager.

resource "google_compute_region_instance_group_manager" "default" {
  name               = "flex-igm"
  base_instance_name = "tf-test-flex-igm"
  region             = "us-central1"

  target_size                      = 3
  distribution_policy_target_shape = "ANY_SINGLE_ZONE"

  version {
    instance_template = google_compute_instance_template.default.id
  }

  instance_flexibility_policy {
    instance_selections {
      name          = "best-choice"
      rank          = 1
      machine_types = ["n1-standard-1", "n1-standard-2"]
    }
    instance_selections {
      name          = "still-ok"
      rank          = 2
      machine_types = ["n2-standard-1"]
    }
    instance_selections {
      name          = "if-nothing-else"
      rank          = 3
      machine_types = ["e2-standard-2"]
    }
  }

  update_policy {
    instance_redistribution_type = "NONE"
    type                         = "OPPORTUNISTIC"
    minimal_action               = "REPLACE"
    max_surge_fixed              = 0
    max_unavailable_fixed        = 6
  }
}

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

REST

Untuk membuat MIG regional dengan beberapa jenis dan preferensi mesin, buat permintaan POST ke metode regionInstanceGroupManagers.insert.

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

{
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": TARGET_SIZE,
  "instanceTemplate": "INSTANCE_TEMPLATE_URL",
  "distributionPolicy": {
    "targetShape": "SHAPE"
  },
  "updatePolicy": {
    "instanceRedistributionType": "NONE"
  },
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "INSTANCE_SELECTION_1": {
        "machineTypes": [
          "MACHINE_TYPE_1",
          "MACHINE_TYPE_2",
          ...
        ],
        "rank": RANK_1
      },
      "INSTANCE_SELECTION_2": {
        "machineTypes": [
          "MACHINE_TYPE_3",
          "MACHINE_TYPE_4",
          ...
        ],
        "rank": RANK_2
      },
      ...
    }
  }
}

MIG zona tidak mendukung fleksibilitas instance. Namun, jika Anda ingin membuat MIG dalam satu zona, tetapkan bentuk distribusi target ke ANY_SINGLE_ZONE. Selain itu, jika Anda menginginkan zona tertentu, gunakan bentuk distribusi ANY_SINGLE_ZONE dan sertakan kolom distributionPolicy.zones[].zone dalam permintaan.

Ganti kode berikut:

• PROJECT_ID: Project ID Anda.
• REGION: region tempat Anda ingin membuat MIG.
• INSTANCE_GROUP_NAME: nama MIG.
• TARGET_SIZE: jumlah VM yang ingin Anda buat dan kelola oleh MIG.
• INSTANCE_TEMPLATE_URL: URL template instance yang ingin Anda gunakan untuk membuat instance di MIG. URL dapat berisi ID atau nama template instance. Tentukan salah satu nilai berikut:
  • Untuk template instance regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
  • Untuk template instance global: INSTANCE_TEMPLATE_ID
• SHAPE: bentuk distribusi target. Nilainya dapat berupa BALANCED, ANY, atau ANY_SINGLE_ZONE. Bentuk distribusi target lainnya tidak didukung.
• INSTANCE_SELECTION: nama daftar jenis mesin.
• MACHINE_TYPE: jenis mesin yang ingin Anda konfigurasi di MIG.
• RANK: angka yang menunjukkan urutan preferensi Anda untuk pemilihan instance. Nilai yang lebih rendah berarti preferensi yang lebih tinggi.

Membuat MIG dengan beberapa jenis mesin, preferensi, dan penggantian tambahan

Pratinjau — Penggantian disk dan platform CPU minimum

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

Saat membuat MIG dengan beberapa jenis mesin, Anda dapat menetapkan platform CPU minimum dan definisi disk untuk setiap pilihan instance secara opsional.

Konsol

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

   Buka Instance groups

2. Klik Create instance group.

3. Di kolom Nama, masukkan nama untuk MIG.

4. Dalam daftar Instance template, pilih template instance yang ingin Anda gunakan untuk MIG.

5. Sebelum dapat menentukan Jumlah instance dan menambahkan Pilihan instance, Anda harus melakukan hal berikut:

   1. Buka bagian Lokasi di halaman dan tetapkan lokasi sebagai berikut:

      1. Pilih Beberapa zona.

      2. Di drop-down Region dan Zona, pilih region dan zona tempat Anda ingin membuat VM di MIG. Jika Anda memilih template instance regional, region template tersebut akan dipilih secara default.

      3. Di kolom Bentuk distribusi target, pilih Seimbang, Apa pun, atau Zona tunggal apa pun.

         • Jika Anda memilih Seimbang atau Zona tunggal apa pun, di dialog yang terbuka, klik Nonaktifkan redistribusi instance.

         • Jika Anda memilih Semua, pastikan kotak Izinkan redistribusi instance tidak dicentang.

   2. Buka bagian Penskalaan otomatis di halaman dan hapus konfigurasi penskalaan otomatis sebagai berikut:

      1. Di menu drop-down Autoscaling mode, klik Delete autoscaling configuration.

      2. Pada dialog yang terbuka, klik Hapus.

   3. Scroll kembali ke kolom Number of instances.

6. Di kolom Number of instances, tentukan jumlah VM yang Anda inginkan dalam grup.

7. Di bagian Pilihan instance, klik Tambahkan pilihan.

   Jendela Instance selections akan terbuka. Ulangi langkah-langkah berikut untuk setiap pilihan instance yang ingin Anda tambahkan di MIG.

   1. Klik Tambahkan pilihan instance.

   2. Di bagian New instance selection, lakukan tindakan berikut:

      1. Di kolom Name, masukkan nama untuk pilihan instance.

      2. Di kolom Rank, masukkan urutan preferensi di antara pilihan instance yang Anda tambahkan untuk MIG.

      3. Di bagian Jenis mesin, klik Tambahkan jenis mesin, pilih jenis mesin yang ingin Anda tambahkan dalam pilihan instance, lalu klik Selesai.

         Ulangi langkah ini untuk setiap jenis mesin yang ingin Anda tambahkan ke pilihan instance.

      4. Jika Anda ingin mengganti platform CPU minimum yang ditentukan dalam template instance, centang kotak Ganti platform CPU untuk pilihan ini. Di daftar CPU platform, pilih platform yang ingin Anda gunakan untuk pemilihan instance.

      5. Jika Anda ingin mengganti konfigurasi disk yang ditentukan dalam template instance atau melampirkan penyimpanan, pilih kotak centang Ganti disk.

         • Untuk mengganti boot disk, di bagian Boot disk, klik Change, lalu ikuti perintahnya.

         • Untuk melampirkan penyimpanan, klik Tambahkan disk baru atau Lampirkan disk yang ada, lalu ikuti perintahnya.

      6. Setelah Anda selesai menambahkan jenis mesin dan penggantian, klik Selesai.

8. Setelah Anda selesai menambahkan pilihan instance, klik Selesai.

9. Biarkan kolom lain tetap pada setelan defaultnya atau ubah sesuai kebutuhan.

10. Klik Create.

gcloud

Gunakan perintah instance-groups managed create.

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --region REGION \
    --size TARGET_SIZE \
    --template INSTANCE_TEMPLATE_URL \
    --force-update-on-repair \
    --target-distribution-shape SHAPE \
    --instance-redistribution-type none \
    --instance-flexibility-policy={"instanceSelections": \
        {"INSTANCE_SELECTION_1":{"rank":RANK_1,"machineTypes":["MACHINE_TYPE_1","MACHINE_TYPE_2"],"minCpuPlatform":"MIN_CPU_PLATFORM_1","disks":[{"deviceName":"DEVICE_NAME_1","boot":true,"initializeParams":{"sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"}}]}, \
        "INSTANCE_SELECTION_2":{"rank":RANK_2,"machineTypes":["MACHINE_TYPE_3","MACHINE_TYPE_4"],"minCpuPlatform":"MIN_CPU_PLATFORM_2","disks":[{"deviceName":"DEVICE_NAME_2","boot":true,"initializeParams":{"sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"}}]}}}

Anda juga dapat menggunakan file YAML atau JSON untuk mengonfigurasi kebijakan fleksibilitas instance. Untuk melakukannya, gunakan flag --flags-file, bukan flag --instance-flexibility-policy, dan tentukan nama file. Misalnya, gunakan --flags-file=FILE_NAME.YAML.

Ganti kode berikut:

• INSTANCE_GROUP_NAME: nama MIG.
• REGION: region tempat Anda ingin membuat MIG.
• TARGET_SIZE: jumlah VM yang ingin Anda buat dan kelola oleh MIG.
• INSTANCE_TEMPLATE_URL: URL template instance yang ingin Anda gunakan untuk membuat instance di MIG. URL dapat berisi ID atau nama template instance. Tentukan salah satu nilai berikut:
  • Untuk template instance regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
  • Untuk template instance global: INSTANCE_TEMPLATE_ID
• SHAPE: bentuk distribusi target. Nilainya dapat berupa balanced, any, atau any-single-zone. Bentuk distribusi target lainnya tidak didukung.
• INSTANCE_SELECTION: nama daftar jenis mesin.
• MACHINE_TYPE: jenis mesin yang ingin Anda konfigurasi di MIG.
• MIN_CPU_PLATFORM: platform CPU minimum untuk instance.
• DEVICE_NAME: nama perangkat untuk disk.
• IMAGE_PROJECT: ID project image sumber.
• IMAGE_NAME: nama image sumber.
• RANK: angka yang menunjukkan urutan preferensi Anda untuk pemilihan instance. Nilai yang lebih rendah berarti preferensi yang lebih tinggi.

REST

Buat permintaan POST ke metode beta regionInstanceGroupManagers.insert.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers

{
"name": "INSTANCE_GROUP_NAME",
"targetSize": "TARGET_SIZE",
"instanceTemplate": "INSTANCE_TEMPLATE_URL",
"distributionPolicy": {
  "targetShape": "SHAPE"
},
"updatePolicy": {
  "instanceRedistributionType": "NONE"
},
"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "YES",
},
"instanceFlexibilityPolicy": {
  "instanceSelections": {
    "INSTANCE_SELECTION_1": {
      "machineTypes": ["MACHINE_TYPE_1", "MACHINE_TYPE_2", …],
      "minCpuPlatform": "MIN_CPU_PLATFORM_1",
      "disks": [
        {
          "deviceName": "DEVICE_NAME_1",
          "initializeParams": {
            "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"
          },
          "boot": true
        }
      ],
      "rank": RANK_1
    },
    "INSTANCE_SELECTION_2": {
      "machineTypes": ["MACHINE_TYPE_3", "MACHINE_TYPE_4", …],
      "minCpuPlatform": "MIN_CPU_PLATFORM_2",
      "disks": [
        {
          "deviceName": "DEVICE_NAME_2",
          "initializeParams": {
            "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"
          },
          "boot": true
        }
      ],
      "rank": RANK_2
    }
  }
}
}

Ganti kode berikut:

• PROJECT_ID: Project ID Anda.
• REGION: region tempat Anda ingin membuat MIG.
• INSTANCE_GROUP_NAME: nama MIG.
• TARGET_SIZE: jumlah VM yang ingin Anda buat dan kelola oleh MIG.
• INSTANCE_TEMPLATE_URL: URL template instance yang ingin Anda gunakan untuk membuat instance di MIG. URL dapat berisi ID atau nama template instance. Tentukan salah satu nilai berikut:
  • Untuk template instance regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
  • Untuk template instance global: INSTANCE_TEMPLATE_ID
• SHAPE: bentuk distribusi target. Nilainya dapat berupa BALANCED, ANY, atau ANY_SINGLE_ZONE. Bentuk distribusi target lainnya tidak didukung.
• INSTANCE_SELECTION: nama daftar jenis mesin.
• MACHINE_TYPE: jenis mesin yang ingin Anda konfigurasi di MIG.
• MIN_CPU_PLATFORM: platform CPU minimum untuk instance.
• DEVICE_NAME: nama perangkat untuk disk.
• IMAGE_PROJECT: ID project image sumber.
• IMAGE_NAME: nama image sumber.
• RANK: angka yang menunjukkan urutan preferensi Anda untuk pemilihan instance. Nilai yang lebih rendah berarti preferensi yang lebih tinggi.

Menambahkan fleksibilitas instance ke MIG yang ada

Anda dapat menambahkan fleksibilitas instance ke MIG yang ada. Anda dapat menetapkan beberapa jenis mesin dan juga menetapkan preferensi untuk jenis mesin tertentu.

Jika MIG Anda sudah memiliki VM, VM tersebut akan terus menggunakan jenis mesin yang ditentukan dalam template instance. Jika Anda ingin VM yang ada di MIG menggunakan jenis mesin dari kebijakan fleksibilitas instance, setelah menambahkan kebijakan, hapus VM yang ada, lalu ubah ukuran MIG ke jumlah VM yang diperlukan. Saat mengubah ukuran, VM baru akan menggunakan jenis mesin dari kebijakan.

Untuk mengubah kebijakan fleksibilitas instance yang ada, lihat Mengubah konfigurasi fleksibilitas instance.

Tambahkan fleksibilitas instance ke MIG dengan salah satu cara berikut:

• Menambahkan beberapa jenis mesin
• Menambahkan beberapa jenis dan preferensi mesin
• Menambahkan beberapa jenis mesin, preferensi, dan penggantian tambahan

Menambahkan beberapa jenis mesin

Konsol

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

   Buka Instance groups

2. Klik nama MIG tempat Anda ingin menetapkan beberapa jenis mesin.

3. Klik Edit.

4. Klik Instance flexibility untuk meluaskan bagian tersebut.

5. Di bagian Pilihan instance, klik Tambahkan pilihan.

   Jendela Instance selections akan terbuka.

   1. Klik Tambahkan pilihan instance.

   2. Di bagian New instance selection, lakukan tindakan berikut:

      1. Di kolom Name, masukkan nama untuk pilihan instance.

      2. Di bagian Jenis mesin, klik Tambahkan jenis mesin, pilih jenis mesin yang ingin Anda tambahkan dalam pilihan instance, lalu klik Selesai.

         Ulangi langkah ini untuk setiap jenis mesin yang ingin Anda tambahkan ke pilihan instance.

      3. Setelah Anda selesai menambahkan jenis mesin, klik Selesai.

6. Di jendela Instance selections, klik Done.

7. Klik Simpan.

gcloud

Untuk menambahkan beberapa jenis mesin ke MIG yang sudah ada, gunakan perintah instance-groups managed update.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --region REGION \
    --instance-selection-machine-types MACHINE_TYPE,MACHINE_TYPE,...

Ganti kode berikut:

• INSTANCE_GROUP_NAME: nama MIG.
• REGION: region tempat MIG berada.
• MACHINE_TYPE: jenis mesin yang ingin Anda konfigurasi di MIG.

REST

Untuk menambahkan beberapa jenis mesin ke MIG yang ada, buat permintaan PATCH ke metode regionInstanceGroupManagers.patch.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
    "INSTANCE_SELECTION": {
        "machineTypes": [
          "MACHINE_TYPE_1",
          "MACHINE_TYPE_2"
          ...
        ]
      }
    }
  }
}

Ganti kode berikut:

• PROJECT_ID: Project ID Anda.
• REGION: region tempat MIG berada.
• INSTANCE_GROUP_NAME: nama MIG.
• INSTANCE_SELECTION: nama daftar jenis mesin.
• MACHINE_TYPE: jenis mesin yang ingin Anda konfigurasi di MIG.
• RANK: angka yang menunjukkan urutan preferensi Anda untuk pemilihan instance. Nilai yang lebih rendah berarti preferensi yang lebih tinggi.

Menambahkan beberapa jenis dan preferensi mesin

Konsol

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

   Buka Instance groups

2. Klik nama MIG tempat Anda ingin menetapkan beberapa jenis mesin.

3. Klik Edit.

4. Klik Instance flexibility untuk meluaskan bagian tersebut.

5. Di bagian Pilihan instance, klik Tambahkan pilihan.

   Jendela Instance selections akan terbuka. Ulangi langkah-langkah berikut untuk setiap pilihan instance yang ingin Anda tambahkan di MIG.

   1. Klik Tambahkan pilihan instance.

   2. Di bagian New instance selection, lakukan tindakan berikut:

      1. Di kolom Name, masukkan nama untuk pilihan instance.

      2. Di kolom Rank, masukkan urutan preferensi di antara pilihan instance yang Anda tambahkan untuk MIG.

      3. Di bagian Jenis mesin, klik Tambahkan jenis mesin, pilih jenis mesin yang ingin Anda tambahkan dalam pilihan instance, lalu klik Selesai.

         Ulangi langkah ini untuk setiap jenis mesin yang ingin Anda tambahkan ke pilihan instance.

      4. Setelah Anda selesai menambahkan jenis mesin, klik Selesai.

6. Setelah Anda selesai menambahkan pilihan instance, klik Selesai.

7. Klik Simpan.

gcloud

Untuk menambahkan beberapa jenis dan preferensi mesin ke MIG yang sudah ada, gunakan perintah instance-groups managed update

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --region REGION \
    --instance-selection "name=INSTANCE_SELECTION_1,machine-type=MACHINE_TYPE_1,machine-type=MACHINE_TYPE_2,rank=RANK_1" \
    --instance-selection "name=INSTANCE_SELECTION_2,machine-type=MACHINE_TYPE_3,machine-type=MACHINE_TYPE_4,rank=RANK_2"

Ganti kode berikut:

• INSTANCE_GROUP_NAME: nama MIG.
• REGION: region tempat MIG berada.
• INSTANCE_SELECTION: nama daftar jenis mesin.
• MACHINE_TYPE: jenis mesin yang ingin Anda konfigurasi di MIG.
• RANK: angka yang menunjukkan urutan preferensi Anda untuk pemilihan instance. Nilai yang lebih rendah berarti preferensi yang lebih tinggi.

REST

Untuk menambahkan beberapa jenis mesin dan preferensi ke MIG yang ada, buat permintaan PATCH ke metode regionInstanceGroupManagers.patch.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "INSTANCE_SELECTION_1": {
        "machineTypes": [
          "MACHINE_TYPE_1",
          "MACHINE_TYPE_2"
        ],
        "rank": RANK_1
      },
      "INSTANCE_SELECTION_2": {
        "machineTypes": [
          "MACHINE_TYPE_3",
          "MACHINE_TYPE_4"
        ],
        "rank": RANK_2
      }
    }
  }
}

Ganti kode berikut:

• PROJECT_ID: Project ID Anda.
• REGION: region tempat MIG berada.
• INSTANCE_GROUP_NAME: nama MIG.
• INSTANCE_SELECTION: nama daftar jenis mesin.
• MACHINE_TYPE: jenis mesin yang ingin Anda konfigurasi di MIG.
• RANK: angka yang menunjukkan urutan preferensi Anda untuk pemilihan instance. Nilai yang lebih rendah berarti preferensi yang lebih tinggi.

Menambahkan beberapa jenis mesin, preferensi, dan penggantian tambahan

Pratinjau — Penggantian disk dan platform CPU minimum

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

Konsol

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

   Buka Instance groups

2. Klik nama MIG tempat Anda ingin menetapkan beberapa jenis mesin.

3. Klik Edit.

4. Klik Instance flexibility untuk meluaskan bagian tersebut.

5. Di bagian Pilihan instance, klik Tambahkan pilihan.

   Jendela Instance selections akan terbuka. Ulangi langkah-langkah berikut untuk setiap pilihan instance yang ingin Anda tambahkan di MIG.

   1. Klik Tambahkan pilihan instance.

   2. Di bagian New instance selection, lakukan tindakan berikut:

      1. Di kolom Name, masukkan nama untuk pilihan instance.

      2. Di kolom Rank, masukkan urutan preferensi di antara pilihan instance yang Anda tambahkan untuk MIG.

      3. Di bagian Jenis mesin, klik Tambahkan jenis mesin, pilih jenis mesin yang ingin Anda tambahkan dalam pilihan instance, lalu klik Selesai.

         Ulangi langkah ini untuk setiap jenis mesin yang ingin Anda tambahkan ke pilihan instance.

      4. Jika Anda ingin mengganti platform CPU minimum yang ditentukan dalam template instance, centang kotak Ganti platform CPU untuk pilihan ini. Di daftar CPU platform, pilih platform yang ingin Anda gunakan untuk pemilihan instance.

      5. Jika Anda ingin mengganti konfigurasi disk yang ditentukan dalam template instance atau melampirkan penyimpanan, pilih kotak centang Ganti disk.

         • Untuk mengganti boot disk, di bagian Boot disk, klik Change, lalu ikuti perintahnya.

         • Untuk melampirkan penyimpanan, klik Tambahkan disk baru atau Lampirkan disk yang ada, lalu ikuti perintahnya.

      6. Setelah Anda selesai menambahkan jenis mesin dan penggantian, klik Selesai.

6. Setelah Anda selesai menambahkan pilihan instance, klik Selesai.

7. Klik Simpan.

gcloud

Untuk menambahkan beberapa jenis mesin, preferensi, dan penggantian properti instance ke MIG yang ada, gunakan perintah instance-groups managed update beta.

Penting: Saat memperbarui kebijakan fleksibilitas instance, Anda harus selalu menentukan semua properti pemilihan instance. Compute Engine akan mengganti properti yang tidak disertakan dalam perintah update Anda. Untuk melihat konfigurasi yang ada, lihat Melihat fleksibilitas instance.

gcloud beta compute instance-groups managed update INSTANCE_GROUP_NAME \
    --region REGION \
    --instance-flexibility-policy= '{"instanceSelections": \
        {"INSTANCE_SELECTION_1":{"rank":RANK_1,"machineTypes":["MACHINE_TYPE_1","MACHINE_TYPE_2"],"minCpuPlatform":"MIN_CPU_PLATFORM_1","disks":[{"device-name":"DEVICE_NAME_1","boot":true,"initializeParams":{"sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"}}]}, \
        "INSTANCE_SELECTION_2":{"rank":RANK_2,"machineTypes":["MACHINE_TYPE_3","MACHINE_TYPE_4"],"minCpuPlatform":"MIN_CPU_PLATFORM_2","disks":[{"device-name":"DEVICE_NAME_2","boot":true,"initializeParams":{"sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"}}]}}}'

Anda juga dapat menggunakan file YAML atau JSON untuk mengonfigurasi kebijakan fleksibilitas instance. Untuk melakukannya, gunakan flag --flags-file, bukan flag --instance-flexibility-policy, dan tentukan nama file. Misalnya, gunakan --flags-file=FILE_NAME.YAML.

Ganti kode berikut:

• INSTANCE_GROUP_NAME: nama MIG.
• REGION: region tempat MIG berada.
• INSTANCE_SELECTION: nama daftar jenis mesin.
• MACHINE_TYPE: jenis mesin yang ingin Anda konfigurasi di MIG.
• MIN_CPU_PLATFORM: platform CPU minimum untuk instance.
• DEVICE_NAME: nama perangkat untuk disk.
• IMAGE_PROJECT: ID project image sumber.
• IMAGE_NAME: nama image sumber.
• RANK: angka yang menunjukkan urutan preferensi Anda untuk pemilihan instance. Nilai yang lebih rendah berarti preferensi yang lebih tinggi.

REST

Untuk menambahkan beberapa jenis mesin, preferensi, dan penggantian properti instance ke MIG yang ada, buat permintaan PATCH ke metode regionInstanceGroupManagers.patch beta.

Penting: Saat memperbarui kebijakan fleksibilitas instance, Anda harus selalu menentukan semua properti pemilihan instance. Compute Engine akan mengganti properti apa pun yang tidak disertakan dalam permintaan update Anda. Untuk melihat konfigurasi yang ada, lihat Melihat fleksibilitas instance.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "INSTANCE_SELECTION_1": {
        "machineTypes": [
          "MACHINE_TYPE_1",
          "MACHINE_TYPE_2"
        ],
        "minCpuPlatform": "MIN_CPU_PLATFORM_1",
        "disks": [
          {
            "deviceName": "DEVICE_NAME_1",
            "initializeParams": {
              "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"
            },
            "boot": true
          }
        ],
        "rank": RANK_1
      },
      "INSTANCE_SELECTION_2": {
        "machineTypes": [
          "MACHINE_TYPE_3",
          "MACHINE_TYPE_4"
        ],
        "minCpuPlatform": "MIN_CPU_PLATFORM_2",
        "disks": [
          {
            "deviceName": "DEVICE_NAME_2",
            "initializeParams": {
              "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"
            },
            "boot": true
          }
        ],
        "rank": RANK_2
      }
    }
  }
}

Ganti kode berikut:

• PROJECT_ID: Project ID Anda.
• REGION: region tempat MIG berada.
• INSTANCE_GROUP_NAME: nama MIG.
• INSTANCE_SELECTION: nama daftar jenis mesin.
• MACHINE_TYPE: jenis mesin yang ingin Anda konfigurasi di MIG.
• MIN_CPU_PLATFORM: platform CPU minimum untuk instance.
• DEVICE_NAME: nama perangkat untuk disk.
• IMAGE_PROJECT: ID project image sumber.
• IMAGE_NAME: nama image sumber.
• RANK: angka yang menunjukkan urutan preferensi Anda untuk pemilihan instance. Nilai yang lebih rendah berarti preferensi yang lebih tinggi.

Contoh file YAML untuk mengonfigurasi fleksibilitas instance

Anda dapat menggunakan file YAML atau JSON untuk mengonfigurasi kebijakan fleksibilitas instance. Untuk melakukannya, gunakan flag --flags-file di perintah gcloud CLI dan tentukan nama file. Misalnya, gunakan --flags-file=FILE_NAME.YAML.

Berikut adalah contoh file YAML:

--instance-flexibility-policy:
  instanceSelections:
    first-preference:
      rank: 1
      machineTypes:
        - n2-standard-8
      minCpuPlatform: "Intel Ice Lake"
      disks:
        - deviceName: data-disk
          boot: false
          initializeParams:
            sourceImage: projects/debian-cloud/global/images/debian-12
            diskType: pd-ssd

Langkah berikutnya

• Lihat konfigurasi fleksibilitas instance.
• Mengubah atau menghapus konfigurasi fleksibilitas.