Menerapkan pembaruan konfigurasi selama perbaikan

---

Dokumen ini menjelaskan cara mengonfigurasi MIG untuk menerapkan template instance terbaru dan konfigurasi per instance saat membuat ulang VM selama operasi perbaikan. Menerapkan konfigurasi terbaru yang tersedia selama operasi perbaikan juga disebut sebagai update saat perbaikan. Dokumen ini juga menjelaskan cara memeriksa apakah update saat perbaikan diaktifkan di MIG Anda, dan jika diaktifkan, bagaimana cara menonaktifkan update saat perbaikan.

Secara default, selama perbaikan, MIG akan membuat ulang VM menggunakan konfigurasi instance yang sama dengan yang awalnya digunakan untuk membuat VM. Jika update untuk template instance grup atau konfigurasi per instance grup tersedia, Anda memiliki opsi untuk menerapkan perubahan ini ke VM yang sedang diperbaiki.

Jika Anda ingin menerapkan update konfigurasi secara otomatis ke semua atau satu set VM (PROACTIVE), atau mengupdate instance tertentu secara selektif (OPPORTUNISTIC), baca bagian Menerapkan konfigurasi baru ke VM dalam sebuah MIG.

Catatan: Jika jenis update MIG Anda disetel ke PROACTIVE dan Anda mengonfigurasi update saat perbaikan, maka MIG tidak akan memperhitungkan maxUnavailable selama pembaruan saat perbaikan. Misalnya, anggaplah maxUnavailable adalah 5 dan MIG sudah dalam proses mengupdate 5 VM berdasarkan kebijakan update. Di antara VM lainnya di MIG, jika 3 VM gagal, MIG akan mengupdate ketiga VM yang gagal selama perbaikan, terlepas dari maxUnavailable.

Sebelum memulai

• Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  REST

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

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

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

Mengonfigurasi update saat perbaikan

Untuk mengonfigurasi update saat perbaikan, gunakan konsol Google Cloud, gcloud CLI, atau REST.

Konsol

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

   Buka Instance groups

2. Klik nama MIG tempat Anda ingin mengonfigurasi update saat perbaikan.

3. Klik Edit untuk mengubah MIG.

4. Di bagian VM instance lifecycle, untuk Updates during VM instance repair, pilih Update the instance configuration.

5. Klik Save.

gcloud

Untuk MIG yang sudah ada, gunakan perintah update:

gcloud compute instance-groups managed update MIG_NAME \
    --force-update-on-repair

Untuk MIG baru, gunakan perintah create:

gcloud compute instance-groups managed create MIG_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --force-update-on-repair

Ganti kode berikut:

• MIG_NAME: Nama grup instance.
• INSTANCE_TEMPLATE: Nama template instance yang akan digunakan untuk grup.
• SIZE: Ukuran target grup instance.

REST

Untuk MIG zona yang sudah ada, gunakan metode instanceGroupManagers.patch, atau, untuk MIG regional yang sudah ada, gunakan metode regionInstanceGroupManagers.patch.

Lakukan panggilan berikut untuk mengonfigurasi update saat perbaikan di MIG zona yang sudah ada:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
"instanceLifecyclePolicy":
  { "forceUpdateOnRepair": YES
  }
}

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

Lakukan panggilan berikut untuk mengonfigurasi update saat perbaikan ketika membuat MIG zona:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers
{
"name": "MIG_NAME",
"instanceTemplate": "INSTANCE_TEMPLATE",
"targetSize": SIZE,
"instanceLifecyclePolicy":
  { "forceUpdateOnRepair": YES
  }
}

Ganti kode berikut:

• PROJECT_ID: Project ID Anda.
• ZONE: Zona tempat MIG berada.
• MIG_NAME: Nama grup instance.
• INSTANCE_TEMPLATE: Nama template instance yang akan digunakan untuk grup.
• SIZE: Ukuran target grup instance.

Memeriksa apakah update saat perbaikan sudah diaktifkan

Secara default, MIG tidak mengupdate VM selama perbaikan. Untuk memeriksa apakah update saat perbaikan sudah diaktifkan untuk MIG Anda, gunakan konsol Google Cloud, gcloud CLI, atau REST untuk melihat konfigurasi update saat perbaikan.

Konsol

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

   Buka Instance groups

2. Klik nama MIG yang konfigurasinya ingin Anda periksa.

3. Klik tab Details.

4. Di bagian VM instance lifecycle, centang opsi yang dipilih untuk Updates during VM instance repair. Jika Update the instance configuration dipilih, update saat perbaikan akan diaktifkan.

gcloud

Gunakan perintah describe sebagai berikut:

gcloud compute instance-groups managed describe MIG_NAME \
--format="(instanceLifecyclePolicy)"

Dalam isi respons, periksa kolom forceUpdateOnRepair, yang memiliki salah satu nilai berikut:

• NO: Default. MIG tidak mengupdate VM saat diperbaiki.
• YES: MIG mengupdate VM selama perbaikan.

Berikut adalah contoh output:

instanceLifecyclePolicy:
 forceUpdateOnRepair: YES

REST

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

Misalnya, di MIG zona, gunakan perintah berikut:

GET https://compute.googleapis.com/compute/v1/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

Dalam isi respons, periksa kolom instanceLifecyclePolicy.forceUpdateOnRepair, yang memiliki salah satu nilai berikut:

• NO: Default. MIG tidak mengupdate VM saat diperbaiki.
• YES: MIG mengupdate VM selama perbaikan.

Berikut adalah contoh respons:

{
...
"name": "example-mig",
"targetSize": 12,
...
"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "YES"
  },
...
}

Ganti kode berikut:

• PROJECT_ID: Project ID Anda.
• ZONE: Zona tempat MIG berada.
• MIG_NAME: Nama grup instance.

Menonaktifkan update saat perbaikan

Saat MIG memperbaiki VM, jika Anda ingin MIG menggunakan template instance asli atau konfigurasi per instance yang digunakan untuk membuat VM, Anda harus menonaktifkan update saat perbaikan. Secara default, update saat perbaikan dinonaktifkan untuk MIG.

Gunakan konsol Google Cloud, gcloud CLI, atau REST untuk menonaktifkan update saat perbaikan.

Konsol

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

   Buka Instance groups

2. Klik nama MIG tempat Anda ingin menonaktifkan update saat perbaikan.

3. Klik Edit untuk mengubah MIG.

4. Di bagian VM instance lifecycle, untuk Updates during VM instance repair, pilih Keep the same instance configuration.

5. Klik Save.

gcloud

Gunakan perintah update untuk menetapkan flag --no-force-update-on-repair sebagai berikut:

gcloud compute instance-groups managed update MIG_NAME \
    --no-force-update-on-repair

REST

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

Misalnya, guna menonaktifkan update saat perbaikan untuk MIG zona, gunakan perintah berikut:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME
{
"instanceLifecyclePolicy":
{ "forceUpdateOnRepair": NO
}
}

Ganti kode berikut:

• PROJECT_ID: Project ID Anda.
• ZONE: Zona tempat MIG berada.
• MIG_NAME: Nama grup instance.

Langkah berikutnya

• Siapkan health check dan autohealing aplikasi.
• Jika Anda telah mengonfigurasi health check berbasis aplikasi untuk MIG Anda, pantau perubahan status respons VM.