Menambahkan dan menghapus VM dari MIG

Konsol

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

   Buka Grup instance

2. Di kolom Name pada daftar, klik nama grup instance tempat Anda ingin mengubah ukuran grup.

3. Klik Edit untuk mengubah grup instance terkelola ini.

4. Di bagian Jumlah instance, tentukan jumlah instance yang ingin Anda sertakan dalam grup instance terkelola ini. Jika Penskalaan otomatis diaktifkan, grup akan otomatis menambahkan atau menghapus instance sesuai kebutuhan. Namun, Anda dapat mengubah nilai Minimum number of instances dan nilai Maximum number of instances untuk menyesuaikan ukuran grup secara tidak langsung melalui Autoscaler.

5. Klik Simpan untuk menerapkan template baru.

gcloud

Gunakan perintah resize.

gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --zone ZONE

REST

Panggil metode resize untuk resource miG tingkat zona atau regional. Tentukan ukuran grup instance baru sebagai parameter.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resize?size=NEW_SIZE

Jika grup instance adalah grup instance terkelola regional, ganti zones/ZONE dengan regions/REGION.

gcloud

Gunakan perintah resize beta dengan flag --no-creation-retries.

gcloud beta compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --no-creation-retries \
    [--region REGION | --zone ZONE]

Ganti kode berikut:

• INSTANCE_GROUP_NAME: Nama MIG yang ingin Anda ubah ukurannya.
• NEW_SIZE: Jumlah target instance yang berjalan dalam grup instance terkelola.
• ZONE: Untuk MIG zona, zona tempat MIG berada.
• REGION: Untuk MIG regional, region tempat MIG berada.

REST

Untuk MIG zona, gunakan metode instanceGroupManagers.resizeAdvanced beta atau, untuk MIG regional, gunakan metode regionInstanceGroupManagers.resizeAdvanced beta ini. Tentukan ukuran grup baru dan kolom noCreationRetries di isi permintaan.

Misalnya, buat panggilan berikut untuk mengubah ukuran MIG zona dengan mode percobaan ulang pembuatan dinonaktifkan.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeAdvanced

{
 "targetSize": NEW_SIZE,
 "noCreationRetries": true
}

Ganti kode berikut:

• PROJECT_ID: Project ID Anda.
• ZONE: Zona tempat MIG berada. Untuk MIG regional, ganti zones/ZONE dengan regions/REGION dan tentukan region-nya. Untuk informasi selengkapnya, lihat Tentang MIG regional.
• INSTANCE_GROUP_NAME: Nama MIG yang ingin Anda ubah ukurannya.

• NEW_SIZE: Jumlah target instance yang berjalan dalam grup instance terkelola.

  Anda dapat melihat instance mana yang sedang dibuat dan dalam mode apa dengan menggunakan metode listManagedInstances. Saat mode percobaan ulang pembuatan dinonaktifkan, instance yang Anda buat memiliki currentAction dari CREATING_WITHOUT_RETRIES.

gcloud

Gunakan perintah instance-groups managed create-instance.

gcloud compute instance-groups managed create-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    [--region REGION | --zone ZONE]

Ganti kode berikut:

• INSTANCE_GROUP_NAME adalah nama MIG regional atau zona yang akan ditambahkan dengan instance baru.
• INSTANCE_NAME adalah nama yang ingin Anda tetapkan ke instance baru.

REST

Kirim permintaan POST ke metode regionInstanceGroupManagers.createInstances. Untuk grup instance terkelola menurut zona, gunakan metode instanceGroupManagers.createInstances. Dalam isi permintaan, sertakan kolom instances dengan nama untuk satu atau beberapa instance.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/createInstances
{
  "instances": [
    {
      "name": "INSTANCE_NAME_1"
    },
    {
      "name": "INSTANCE_NAME_2"
    }
  ]
}

Konsol

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

   Buka Grup instance

2. Di kolom Name pada daftar, klik nama grup instance tempat Anda ingin menghapus instance satu per satu. Halaman akan terbuka dengan properti grup instance dan daftar instance yang disertakan dalam grup tersebut.

3. Di bagian Anggota, dari daftar instance, pilih satu atau beberapa instance yang ingin dihapus.

4. Klik Hapus instance. Instance yang dipilih akan dihapus.

gcloud

Untuk menghapus instance dengan gcloud CLI, gunakan perintah instance-groups managed delete-instances.

gcloud compute instance-groups managed delete-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

Perintah ini menampilkan status operasi per instance:

• SUCCESS ditampilkan jika gcloud CLI menghapus instance.
• FAIL ditampilkan untuk semua instance jika salah satu instance yang Anda tentukan dalam permintaan bukan anggota grup, jika ada anggota yang sudah dihapus atau diabaikan, atau jika permintaan gagal karena alasan lain.
• SKIPPED hanya ditampilkan jika Anda menggunakan flag --skip-instances-on-validation-error dan instance bukan merupakan anggota grup atau sudah dihapus atau diabaikan.
• MEMBER_NOT_FOUND hanya ditampilkan untuk grup regional jika gcloud CLI tidak dapat me-resolve zona dari nama instance.

Jika Anda mengantisipasi bahwa permintaan penghapusan mungkin bertentangan dengan operasi serentak, gunakan flag --skip-instances-on-validation-error. Flag ini menentukan apakah permintaan harus dilanjutkan meskipun permintaan menyertakan instance yang bukan anggota grup, atau yang telah dihapus atau diabaikan—misalnya, instance yang dihapus oleh autoscaler. Secara default, jika Anda menghilangkan flag ini dan instance tersebut ditentukan dalam permintaan, operasi akan gagal. Operasi akan selalu gagal jika permintaan berisi nama instance yang diformat dengan buruk atau referensi ke instance yang ada di zona atau region selain zona atau region grup tersebut.

Misalnya, perintah berikut meminta penghapusan empat instance, tetapi tiga di antaranya tidak lagi berada dalam grup:

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1 \
    --skip-instances-on-validation-error

Dalam contoh ini, tiga instance tidak lulus validasi, sehingga instance tersebut dilewati, sementara example-instance-3 dihapus:

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE           INSTANCE               STATUS   VALIDATION_ERROR
example-project  us-central1-a  example-instance-1     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-1 that was already deleted.
example-project  us-central1-a  example-instance-2     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-2 that was already abandoned.
example-project  us-central1-a  example-instance-3     SUCCESS
example-project  us-central1-a  example-instance-4     SKIPPED  Cannot find instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-4.

Jika Anda menghilangkan flag --skip-instances-on-validation-error dan jika ada instance yang tidak lulus validasi, tidak ada instance yang dihapus:

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE             INSTANCE              STATUS
example-project  us-central1-a    example-instance-1    FAIL
example-project  us-central1-a    example-instance-2    FAIL
example-project  us-central1-a    example-instance-3    FAIL
example-project  us-central1-a    example-instance-4    FAIL

REST

Kirim permintaan POST ke metode regionInstanceGroupManagers.deleteInstances. Untuk grup instance terkelola menurut zona, gunakan metode instanceGroupManagers.deleteInstances.

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

{
  "instances": [
    "zones/ZONE/instances/INSTANCE_NAME_1",
    "zones/ZONE/instances/INSTANCE_NAME_2"
   ]
}

Jika Anda mengantisipasi bahwa permintaan penghapusan mungkin bertentangan dengan operasi serentak, gunakan kolom skipInstancesOnValidationError. Kolom ini menentukan apakah permintaan harus dilanjutkan meskipun permintaan menyertakan instance yang bukan anggota grup, atau yang telah dihapus atau diabaikan—misalnya, instance yang dihapus oleh autoscaler. Secara default, jika Anda menghilangkan flag ini dan instance tersebut ditentukan dalam permintaan, operasi akan gagal. Operasi akan selalu gagal jika permintaan berisi nama instance yang diformat dengan buruk atau referensi ke instance yang ada di zona atau region selain zona atau region grup tersebut.

Misalnya, permintaan untuk menghapus 2 instance berikut akan berhasil meskipun salah satu instance sudah dihapus atau sedang dihapus:

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

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ],
 "skipInstancesOnValidationError": true
}

Anda dapat melihat instance yang dilewati dalam operasi dengan melihat operasinya. Untuk MIG regional, gunakan metode regionOperations.get. Untuk MIG zona, gunakan metode zoneOperations.get. Peringatan tercantum di kolom peringatan operasi.

Konsol

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

   Buka Grup instance

2. Pada kolom Name di daftar, klik nama grup instance tempat Anda ingin menghapus instance. Halaman akan terbuka dengan properti grup instance dan daftar instance yang disertakan dalam grup tersebut.

3. Di bagian Anggota, dari daftar instance, pilih satu atau beberapa instance yang ingin dihapus dari grup.

4. Klik Hapus dari grup. Instance yang dipilih keluar dari grup, tetapi terus berjalan di luar grup.

gcloud

Untuk menghapus instance dari grup instance tanpa menghapus VM, gunakan perintah instance-groups managed abandon-instances.

gcloud compute instance-groups managed abandon-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

REST

Kirim permintaan POST ke metode regionInstanceGroupManagers.abandonInstances. Untuk grup instance terkelola menurut zona, gunakan metode instanceGroupManagers.abandonInstances.

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

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ]
}

Konsol

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

   Buka Grup instance

2. Di kolom Name pada daftar, klik nama grup instance yang ingin Anda tingkatkan batas ukurannya.

3. Klik Edit untuk mengubah grup instance.

4. Perluas bagian setelan lanjutan dengan mengklik Show Advanced Configuration.

5. Di bagian Managed instance list API call results, pilih opsi Paginated.

6. Klik Save untuk menerapkan perubahan.

gcloud

Untuk MIG yang sudah ada, gunakan perintah update:

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --list-managed-instances-results=PAGINATED

Untuk MIG baru, gunakan perintah create:

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --list-managed-instances-results=PAGINATED

Terraform

Untuk meningkatkan batas ukuran MIG, tetapkan argumen list_managed_instances_results ke PAGINATED.

Contoh berikut meningkatkan batas ukuran MIG zona. Untuk mengetahui informasi selengkapnya tentang resource yang digunakan dalam contoh, lihat resource google_compute_instance_group_manager. Untuk MIG regional, gunakan resource google_compute_region_instance_group_manager.

resource "google_compute_instance_group_manager" "default" {
  name                           = "my-igm"
  base_instance_name             = "test"
  target_size                    = 7
  zone                           = "us-central1-f"
  list_managed_instances_results = "PAGINATED"
  version {
    instance_template = google_compute_instance_template.default.id
    name              = "primary"
  }
}

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

REST

Untuk MIG zona yang ada, gunakan metode instanceGroupManagers.patch atau, untuk MIG regional, gunakan metode regionInstanceGroupManagers.patch –misalnya:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/region/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME

{
  "listManagedInstancesResults": "PAGINATED",
}

Untuk MIG zona baru, gunakan metode instanceGroupManagers.insert atau, untuk MIG regional, gunakan metode regionInstanceGroupManagers.insert.