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.
Sebelum memulai
-
Siapkan autentikasi, jika Anda belum melakukannya.
Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud.
Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.
Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
Konsol
Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.
gcloud
-
Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
gcloud init - Menetapkan 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, lalu initialize dengan menjalankan perintah berikut:
gcloud init -
Mengonfigurasi update saat perbaikan
Untuk mengonfigurasi update terkait reparasi, gunakan Konsol Google Cloud, gcloud CLI, atau REST.
Konsol
Di Konsol Google Cloud, buka halaman Instance groups.
Klik nama MIG tempat Anda ingin mengonfigurasi update saat perbaikan.
Klik Edit untuk mengubah MIG.
Di bagian VM instance lifecycle, untuk Updates during VM instance repair, pilih Update the instance configuration.
Klik Simpan.
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://www.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://www.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 perbaikan diaktifkan untuk MIG Anda, gunakan Konsol Google Cloud, gcloud CLI, atau REST untuk melihat info terbaru tentang konfigurasi perbaikan.
Konsol
Di Konsol Google Cloud, buka halaman Instance groups.
Klik nama MIG yang konfigurasinya ingin Anda periksa.
Klik tab Details.
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 memperbarui 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/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME
Dalam isi respons, periksa kolom instanceLifecyclePolicy.forceUpdateOnRepair, yang memiliki salah satu nilai berikut:
NO: Default. MIG tidak memperbarui 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
Di Konsol Google Cloud, buka halaman Instance groups.
Klik nama MIG tempat Anda ingin menonaktifkan update saat perbaikan.
Klik Edit untuk mengubah MIG.
Di bagian VM instance lifecycle, untuk Updates during VM instance repair, pilih Keep the same instance configuration.
Klik Simpan.
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://www.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 selanjutnya
- Siapkan health check dan autohealing aplikasi.
- Jika Anda telah mengonfigurasi health check berbasis aplikasi untuk MIG Anda, pantau perubahan status respons VM.