Menerapkan update konfigurasi VM secara otomatis di MIG

---

Dokumen ini menjelaskan cara menerapkan update konfigurasi secara otomatis ke instance virtual machine (VM) dalam grup instance terkelola (MIG).

Compute Engine mengelola VM dalam MIG berdasarkan komponen konfigurasi yang Anda gunakan: template instance, konfigurasi semua instance opsional, dan konfigurasi stateful opsional.

Setiap kali Anda mengupdate konfigurasi VM MIG dengan mengubah komponen tersebut, Compute Engine akan otomatis menerapkan konfigurasi yang diupdate ke VM baru yang ditambahkan ke grup.

Untuk menerapkan konfigurasi yang diupdate ke VM yang sudah ada, Anda dapat menyiapkan update otomatis, juga dikenal sebagai jenis update proaktif. MIG otomatis meluncurkan update konfigurasi ke semua atau sebagian VM grup. Anda dapat mengontrol kecepatan deployment, tingkat gangguan pada layanan, dan, dengan menggunakan update canary, jumlah instance yang diupdate MIG dengan konfigurasi baru. Setelah menentukan konfigurasi baru, Anda tidak perlu memberikan input tambahan dan update akan selesai dengan sendirinya.

Atau, jika Anda ingin menerapkan konfigurasi baru secara selektif hanya untuk instance baru atau ke instance tertentu dalam MIG, lihat Menerapkan update konfigurasi VM secara selektif di MIG. Untuk membantu Anda membuat keputusan, baca Metode untuk menerapkan konfigurasi baru ke VM yang ada.

Sebelum memulai

• Jika Anda mengupdate MIG stateful, tinjau Menerapkan, melihat, dan menghapus konfigurasi stateful dalam MIG.
• 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

  1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

     gcloud init

     Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi baru dengan menjalankan gcloud components update.
  2. 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

Batasan

• Jika Anda memiliki MIG stateful dan ingin menggunakan update berkelanjutan, Anda harus mempertahankan nama instance saat mengganti instance atau, secara ekuivalen, menetapkan metode penggantian ke RECREATE.

Memulai update berkelanjutan dasar

Update berkelanjutan dasar adalah update yang diterapkan secara bertahap ke semua instance dalam MIG hingga semua instance diupdate ke konfigurasi terbaru yang diinginkan. Update berkelanjutan akan otomatis melewati instance yang sudah dalam konfigurasi terbaru.

Anda dapat mengontrol berbagai aspek update berkelanjutan, seperti jumlah instance yang dapat dibuat offline untuk update, lama waktu tunggu di antara update instance, apakah template baru memengaruhi semua atau hanya sebagian instance, dan seterusnya.

Berikut adalah hal-hal yang perlu diperhatikan saat melakukan update berkelanjutan:

• Update didasarkan pada intent. Saat Anda membuat permintaan update awal, Compute Engine API akan menampilkan respons keberhasilan untuk mengonfirmasi bahwa permintaan tersebut valid, tetapi tidak menunjukkan bahwa update berhasil. Anda harus memeriksa status grup untuk menentukan apakah update berhasil di-deploy.

• Instance Group Updater API adalah API deklaratif. API mengharapkan permintaan untuk menentukan konfigurasi pasca-update MIG yang diinginkan, bukan panggilan fungsi eksplisit.

• Update otomatis mendukung hingga dua versi template instance dalam MIG Anda. Artinya Anda dapat menentukan dua versi template instance yang berbeda untuk grup Anda, yang berguna untuk menjalankan update canary.

Untuk memulai update berkelanjutan dasar dengan update diterapkan ke semua instance dalam grup, ikuti petunjuk di bawah.

Izin yang diperlukan untuk langkah ini

Untuk menjalankan tugas ini, Anda harus memiliki izin berikut:

• Untuk MIG zona, semua izin yang diperlukan untuk memanggil metode instanceGroupManagers.patch
• Untuk MIG regional, semua izin yang diperlukan untuk memanggil metode regionInstanceGroupManagers.patch

Konsol

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

   Buka Instance groups

2. Pilih MIG yang ingin diperbarui.

3. Klik Update VMs.

4. Di bagian New template, klik menu drop-down dan pilih template baru yang akan diupdate. Ukuran target secara otomatis ditetapkan ke 100%, yang menunjukkan bahwa semua instance Anda akan diupdate.

5. Di bagian Update configuration, luaskan menu pilihan dan pilih Automatic sebagai Update type. Biarkan nilai default untuk opsi lainnya.

6. Klik Update VMs untuk memulai update.

gcloud

Gunakan perintah rolling-action start-update.

gcloud compute instance-groups managed rolling-action start-update INSTANCE_GROUP_NAME \
    --version=template=INSTANCE_TEMPLATE_NAME
    [--zone=ZONE | --region=REGION]

Ganti kode berikut:

• INSTANCE_GROUP_NAME: nama MIG
• INSTANCE_TEMPLATE_NAME: template instance baru
• ZONE: untuk MIG zona, masukkan zona
• REGION: untuk MIG regional, masukkan region

REST

Panggil metode patch pada resource miG regional atau zonal.

Misalnya, untuk MIG regional, permintaan berikut menunjukkan konfigurasi minimal yang diperlukan untuk mengupdate 100% instance secara otomatis ke template instance baru.

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

{
  "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE",
  "updatePolicy": {
    "type": "PROACTIVE"
   }
}

Setelah membuat permintaan, Anda dapat memantau update untuk mengetahui kapan update selesai.

Untuk konfigurasi lanjutan, sertakan opsi update lainnya. Jika Anda tidak menentukan sebaliknya, opsi maxSurge dan maxUnavailable akan ditetapkan secara default ke 1 dikalikan dengan jumlah zona yang terpengaruh. Artinya, hanya 1 instance yang akan dibuat offline di setiap zona yang terpengaruh, dan MIG hanya membuat 1 instance tambahan per zona, selama update.

Mengonfigurasi opsi untuk update Anda

Untuk update yang lebih kompleks, Anda dapat mengonfigurasi opsi tambahan, seperti dijelaskan di bagian berikut.

Mengupdate jenis

Grup instance terkelola mendukung dua jenis update:

• Update otomatis, atau proaktif
• Update selektif, atau oportunistik

Jika Anda ingin menerapkan update secara otomatis, setel jenis ke proaktif.

Atau, jika update otomatis berpotensi terlalu mengganggu, Anda dapat memilih untuk menjalankan update oportunistik. MIG menerapkan update oportunistik hanya ketika Anda memulai update secara manual pada instance yang dipilih atau saat instance baru dibuat. Instance baru dapat dibuat saat Anda atau layanan lain, seperti autoscaler, mengubah ukuran MIG. Compute Engine tidak secara aktif memulai permintaan untuk menerapkan update oportunistik pada instance yang ada.

Untuk mengetahui informasi lebih lanjut tentang update otomatis vs selektif, baca Metode untuk menerapkan konfigurasi baru ke VM yang ada.

Lonjakan maksimum

Gunakan opsi maxSurge untuk mengonfigurasi jumlah instance baru yang dapat dibuat oleh MIG di atas targetSize selama update otomatis. Misalnya, jika Anda menyetel maxSurge ke 5, MIG akan menggunakan template instance baru untuk membuat hingga 5 instance baru di atas ukuran target Anda. Menetapkan nilai maxSurge yang lebih tinggi akan mempercepat update, dengan mengorbankan instance tambahan, yang akan ditagih sesuai dengan sheet harga Compute Engine.

Anda dapat menentukan angka tetap, atau persentase jika grup memiliki 10 instance atau lebih. Jika Anda menyetel persentase, Updater akan membulatkan jumlah instance jika diperlukan.

Jika Anda tidak menetapkan nilai maxSurge, nilai default akan digunakan. Untuk MIG zona, nilai default untuk maxSurge adalah 1. Untuk MIG regional, nilai defaultnya adalah jumlah zona yang terkait dengan grup, secara default 3.

maxSurge hanya berfungsi jika Anda memiliki cukup kuota atau resource untuk mendukung resource tambahan.

Jika update Anda tidak mengharuskan penggantian VM, opsi ini akan diabaikan. Anda dapat memaksa VM untuk diganti selama update dengan menyetel opsi tindakan minimal.

Ketidaktersediaan maksimum

Gunakan opsi maxUnavailable untuk mengonfigurasi jumlah instance yang tidak tersedia kapan saja selama update otomatis. Misalnya, jika Anda menyetel maxUnavailable ke 5, hanya 5 instance yang akan dibuat offline untuk diupdate pada satu waktu. Gunakan opsi ini untuk mengontrol seberapa mengganggu update terhadap layanan Anda dan mengontrol kecepatan delpoyment update.

Jumlah ini juga mencakup instance yang tidak tersedia karena alasan lain. Misalnya, jika grup sedang dalam proses diubah ukurannya, instance yang sedang dibuat mungkin tidak tersedia. Instance ini dihitung dalam jumlah maxUnavailable.

Anda dapat menentukan angka tetap, atau persentase jika grup memiliki 10 instance atau lebih. Jika Anda menyetel persentase, Updater akan membulatkan ke bawah jumlah instance, jika perlu.

Jika Anda tidak menginginkan mesin yang tidak tersedia selama update, setel nilai maxUnavailable ke 0 dan nilai maxSurge ke lebih besar dari 0. Dengan setelan ini, Compute Engine akan menghapus setiap mesin lama hanya setelah mesin baru penggantinya dibuat dan dijalankan.

Jika Anda tidak menyetel nilai maxUnavailable, nilai default akan digunakan. Untuk MIG zona, nilai defaultnya adalah 1. Untuk MIG regional, nilai defaultnya adalah jumlah zona yang terkait dengan grup, secara default 3.

Catatan: Jika Anda menyetel properti maxSurge dan maxUnavailable serta kedua properti ditetapkan ke 0, Updater akan otomatis menyetel maxUnavailable=1, untuk memastikan update otomatis selalu dapat dilanjutkan.

Waktu tunggu minimum

Catatan: minReadySec hanya tersedia dalam Compute Engine API beta dan mungkin tidak digunakan lagi dalam rilis mendatang.

Gunakan opsi minReadySec untuk menentukan jumlah waktu tunggu sebelum mempertimbangkan instance baru atau yang dimulai ulang sebagai diupdate. Gunakan opsi ini untuk mengontrol tingkat deployment update otomatis. Timer dimulai saat kedua kondisi berikut terpenuhi:

• Status instance adalah RUNNING.
• Jika health check diaktifkan, saat health check menampilkan HEALTHY.

Perlu diperhatikan bahwa agar health check kembali responsif, Updater menunggu kondisi berikut:

1. Menunggu hingga jangka waktu yang ditentukan oleh nilai autohealingPolicies.initialDelaySec MIG agar health check ditampilkan sebagai HEALTHY.
2. Lalu, menunggu selama jangka waktu yang ditentukan oleh minReadySec.

Jika health check tidak menampilkan HEALTHY dalam initialDelaySec, Updater akan mendeklarasikan instance VM sebagai tidak responsif dan berpotensi menghentikan update. Sementara instance VM menunggu verifikasi selama jangka waktu initialDelaySec dan minReadySec, currentAction instance adalah VERIFYING. Namun, status instance VM yang mendasarinya tetap RUNNING.

Jika tidak ada health check untuk grup, timer akan dimulai saat status instance adalah RUNNING.

Nilai maksimum untuk kolom minReadySec adalah 3600 detik (1 jam).

Diagram berikut menunjukkan pengaruh opsi ukuran target, tidak tersedia maksimum, lonjakan maksimum, dan waktu tunggu minimum terhadap instance Anda. Untuk informasi selengkapnya tentang ukuran target, baca Update canary.

Tindakan minimal

Gunakan opsi tindakan minimal untuk meminimalkan gangguan sebanyak mungkin atau untuk menerapkan tindakan yang lebih mengganggu daripada yang benar-benar diperlukan. Misalnya, Compute Engine tidak perlu memulai ulang VM untuk mengubah metadatanya. Namun, jika aplikasi Anda hanya membaca metadata instance saat VM dimulai ulang, Anda dapat menyetel tindakan minimal untuk memulai ulang agar dapat mengambil perubahan metadata.

Jika update memerlukan tindakan yang lebih mengganggu daripada yang Anda setel dengan flag ini, Compute Engine akan melakukan tindakan yang diperlukan untuk menjalankan update. Misalnya, jika Anda menentukan mulai ulang sebagai tindakan minimal, Updater akan mencoba memulai ulang instance untuk menerapkan update. Namun, jika Anda mengubah OS, yang tidak dapat dilakukan dengan memulai ulang instance, Updater akan mengganti instance dalam grup dengan instance VM baru.

Untuk informasi selengkapnya, termasuk opsi yang valid, baca Mengontrol tingkat gangguan selama update berkelanjutan.

Tindakan paling mengganggu yang diizinkan

Gunakan opsi tindakan paling mengganggu yang diizinkan untuk mencegah update jika memerlukan lebih banyak gangguan dari yang Anda mampu. Jika update tidak dapat diselesaikan karena setelan ini, update akan gagal dan VM Anda mempertahankan konfigurasi sebelumnya.

Untuk informasi selengkapnya, baca Mengontrol tingkat gangguan selama update berkelanjutan.

Metode penggantian

Secara default, ketika Anda mengupdate MIG secara proaktif, grup tersebut akan menghapus instance VM Anda dan menukarnya dengan instance baru dengan nama baru. Jika perlu mempertahankan nama instance VM, gunakan opsi replacementMethod.

Mempertahankan nama instance yang ada mungkin berguna jika Anda memiliki aplikasi atau sistem yang mengandalkan penggunaan nama instance tertentu. Misalnya, beberapa aplikasi, seperti Memcached, mengandalkan nama instance karena tidak memiliki layanan penemuan; akibatnya, setiap kali nama instance berubah, aplikasi akan kehilangan koneksi ke VM spesifik tersebut.

Untuk mempertahankan nama instance, setel metode pengganti ke RECREATE, bukan SUBSTITUTE, jika Anda mengupdate MIG dengan gcloud CLI atau Compute Engine API. Atau, jika Anda mengupdate MIG dari Google Cloud Console, pilih kotak centang Keep instance names whenreplace instances.

Nilai replacementMethod yang valid adalah:

• SUBSTITUTE (default). Mengganti instance VM lebih cepat selama update karena VM baru dibuat sebelum VM lama dimatikan. Namun, nama instance tidak dipertahankan karena nama tersebut masih digunakan oleh instance lama.

• RECREATE. Mempertahankan nama instance melalui update. Compute Engine merilis nama instance saat VM lama dimatikan. Kemudian, Compute Engine membuat instance baru menggunakan nama yang sama. Untuk menggunakan mode ini, Anda harus menyetel maxSurge ke 0.

Catatan: Jika Anda menyetel metode pengganti ke RECREATE, nama instance akan dipertahankan. Namun, ID instance dan stempel waktu pembuatan mungkin berubah. Untuk mengonfirmasi bahwa operasi RECREATE telah membuat instance baru saat stempel waktu pembuatan instance tidak berubah, periksa stempel waktu pembuatan boot disk yang terpasang pada instance tersebut.

Untuk mengetahui informasi selengkapnya, baca Mempertahankan nama instance.

Contoh update tambahan

Berikut beberapa contoh command line dengan opsi konfigurasi umum.

Lakukan update berkelanjutan pada semua instance VM, tetapi buat hingga 5 instance baru di atas ukuran target pada satu waktu

gcloud compute instance-groups managed rolling-action start-update INSTANCE_GROUP_NAME \
    --version=template=NEW_TEMPLATE \
    --max-surge=5 \
    [--zone=ZONE | --region=REGION]

Jalankan update berkelanjutan dengan maksimal 3 mesin yang tidak tersedia dan waktu tunggu minimum 3 menit sebelum menandai instance baru sebagai tersedia

gcloud beta compute instance-groups managed rolling-action start-update INSTANCE_GROUP_NAME \
    --version=template=NEW_TEMPLATE \
    --min-ready=3m \
    --max-unavailable=3 \
    [--zone=ZONE | --region=REGION]

Lakukan update berkelanjutan pada semua instance VM, tetapi buat hingga 10% instance baru di atas ukuran target pada satu waktu

Misalnya, jika Anda memiliki 1.000 instance dan menjalankan perintah berikut, Updater akan membuat hingga 100 instance sebelum mulai menghapus instance yang menjalankan template instance sebelumnya.

gcloud compute instance-groups managed rolling-action start-update INSTANCE_GROUP_NAME \
    --version=template=NEW_TEMPLATE \
    --max-surge=10% \
    [--zone=ZONE | --region=REGION]

Update Canary

Update canary adalah update yang diterapkan ke subset instance dalam grup. Dengan update canary, Anda dapat menguji fitur baru atau upgrade pada subset instance acak, bukan meluncurkan update yang berpotensi mengganggu ke semua instance Anda. Jika update tidak berjalan dengan baik, Anda hanya perlu me-roll back subset instance, sehingga meminimalkan gangguan bagi pengguna Anda.

Update canary sama dengan update berkelanjutan standar, hanya saja jumlah instance yang harus diupdate kurang dari ukuran total grup instance. Seperti update berkelanjutan standar, Anda dapat mengonfigurasi opsi tambahan untuk mengontrol tingkat gangguan terhadap layanan.

Memulai update canary

Untuk memulai update canary, tentukan hingga dua versi template instance, biasanya template instance baru ke canary dan template instance saat ini untuk sisa instance. Misalnya, Anda dapat menentukan bahwa 20% instance Anda dibuat berdasarkan NEW_INSTANCE_TEMPLATE sementara instance lainnya terus berjalan di OLD_INSTANCE_TEMPLATE. Anda tidak dapat menentukan lebih dari dua template instance sekaligus. NEW_INSTANCE_TEMPLATE dapat berupa template instance regional dari region yang sama dengan MIG Anda atau template instance global.

Anda harus selalu menentukan ukuran target (targetSize) untuk versi canary. Anda tidak dapat memulai update canary jika menghapus ukuran target untuk versi canary. Misalnya, jika Anda menentukan bahwa 10% instance harus digunakan untuk canary, 90% sisanya tidak akan disentuh dan menggunakan template instance saat ini.

Izin yang diperlukan untuk langkah ini

Untuk menjalankan tugas ini, Anda harus memiliki izin berikut:

• Untuk MIG zona, semua izin yang diperlukan untuk memanggil metode instanceGroupManagers.patch
• Untuk MIG regional, semua izin yang diperlukan untuk memanggil metode regionInstanceGroupManagers.patch

Konsol

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

   Buka Instance groups

2. Pilih grup instance terkelola yang ingin diupdate.
3. Klik Update VMs.
4. Klik Add a second template dan pilih template instance baru ke canary.
5. Di bagian Target size, masukkan persentase atau jumlah tetap instance yang ingin Anda gunakan untuk melakukan canary template instance baru.
6. Jika mau, Anda dapat mengonfigurasi opsi update lainnya.
7. Klik Update VMs untuk memulai update.

gcloud

Gunakan perintah rolling-action start-update. Masukkan template saat ini dan template baru untuk secara eksplisit menyatakan jumlah instance yang harus menggunakan setiap template:

gcloud compute instance-groups managed rolling-action start-update INSTANCE_GROUP_NAME \
    --version=template=CURRENT_INSTANCE_TEMPLATE_NAME \
    --canary-version=template=NEW_TEMPLATE,target-size=SIZE \
    [--zone=ZONE | --region=REGION]

Ganti kode berikut:

• INSTANCE_GROUP_NAME: nama grup instance.
• CURRENT_INSTANCE_TEMPLATE_NAME: template instance tempat grup instance sedang berjalan.
• NEW_TEMPLATE: template baru yang ingin Anda lakukan canary.
• SIZE: jumlah atau persentase instance tempat Anda ingin menerapkan pembaruan ini. Anda harus menerapkan properti target-size ke template --canary-version. Anda hanya dapat menyetel persentase jika grup berisi 10 instance atau lebih.
• ZONE: untuk MIG zona, masukkan zona.
• REGION: untuk MIG regional, masukkan region,

Misalnya, perintah berikut melakukan update canary yang meluncurkan example-template-B hingga 10% instance dalam grup:

gcloud compute instance-groups managed rolling-action start-update example-mig \
    --version=template=example-template-A \
    --canary-version=template=example-template-B,target-size=10%

REST

Panggil metode patch pada resource miG regional atau zonal. Di isi permintaan, sertakan template instance saat ini dan template instance baru yang ingin di-canary. Contoh:

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

{
 "versions": [
  {
   "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE",
   "targetSize": {
    "[percent|fixed]": NUMBER|PERCENTAGE # Use `fixed` for a specific number of instances
   }
  },
  {
   "instanceTemplate": "global/instanceTemplates/CURRENT_INSTANCE_TEMPLATE_NAME"
  }
 ]
}

Ganti kode berikut:

• NEW_TEMPLATE: nama template baru yang ingin di-canary.
• NUMBER|PERCENTAGE: angka tetap atau persentase instance untuk melakukan update canary. Anda hanya dapat menyetel persentase jika grup berisi 10 instance atau lebih. Jika tidak, berikan angka tetap.
• CURRENT_INSTANCE_TEMPLATE_NAME: nama template instance saat ini yang dijalankan oleh grup.

Untuk opsi selengkapnya, baca Mengonfigurasi opsi untuk update.

Setelah membuat permintaan, Anda dapat memantau update untuk mengetahui kapan update selesai.

Meluncurkan update canary

Setelah menjalankan update canary, Anda dapat membuat keputusan apakah ingin meng-commit update hingga 100% MIG atau melakukan roll back.

Konsol

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

   Buka Instance groups

2. Pilih grup instance terkelola yang ingin diupdate.
3. Klik Update VMs.
4. Di bagian New template, update ukuran target template canary menjadi 100% untuk meluncurkan template ke semua instance Anda. Atau, Anda dapat mengganti template utama dengan template canary yang menghapus kolom template kedua.
5. Klik Update VMs untuk memulai update.

gcloud

Jika ingin meng-commit update canary, luncurkan update dengan mengeluarkan perintah rolling-action start-update lainnya, tetapi hanya setel flag version dan hapus --canary-version.

gcloud compute instance-groups managed rolling-action start-update INSTANCE_GROUP_NAME \
    --version=template=NEW_TEMPLATE \
    [--zone=ZONE | --region=REGION]

REST

Panggil metode patch pada resource miG regional atau zonal. Di isi permintaan, tentukan template instance baru sebagai version dan hapus template instance sebelumnya dari isi permintaan. Hapus spesifikasi ukuran target untuk meluncurkan update ke 100% instance. Contoh:

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

{
"versions": [
   {
   "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE" # New instance template
   }
 ]
}

Memantau update

Setelah Anda memulai update, perlu waktu beberapa saat agar konfigurasi baru selesai diluncurkan ke semua instance yang terpengaruh. Anda dapat memantau progres update dengan memeriksa hal berikut:

• Untuk memastikan apakah semua VM telah menjangkau versi template targetnya, lihat status grup.
• Untuk memastikan bahwa VM tertentu telah menjangkau versi template targetnya, baca tindakan saat ini pada instance.
• Untuk MIG stateful, baca juga Memverifikasi apakah konfigurasi per instance telah diterapkan.

Status grup

Di tingkat grup, Compute Engine mengisi kolom hanya baca yang disebut status yang berisi flag versionTarget.isReached dan flag isStable. Anda dapat menggunakan gcloud CLI atau REST untuk mengakses flag ini. Anda juga dapat menggunakan konsol Google Cloud untuk melihat pembaruan jumlah instance saat ini dan yang direncanakan.

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut:

• compute.instanceGroupManagers.get di MIG

Konsol

Anda dapat memantau update berkelanjutan untuk suatu grup dengan membuka halaman detail grup tersebut.

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

   Buka Instance groups

2. Pilih grup instance terkelola yang ingin Anda pantau. Halaman ringkasan untuk grup tersebut menampilkan template yang digunakan oleh setiap instance.
3. Untuk melihat detailnya, klik tab Details.
4. Di bagian Instance template, Anda dapat melihat jumlah instance saat ini dan target untuk setiap template instance, serta parameter update.

gcloud

Gunakan perintah describe.

gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    [--zone=ZONE | --region=REGION]

Anda juga dapat menggunakan perintah gcloud compute instance-groups managed wait-until dengan flag --version-target-reached untuk menunggu hingga status.versionTarget.isReached disetel ke true untuk grup .

gcloud compute instance-groups managed wait-until INSTANCE_GROUP_NAME \
    --version-target-reached \
    [--zone=ZONE | --region=REGION]

REST

Panggil metode get pada resource miG regional atau zonal.

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

Memverifikasi apakah peluncuran update telah selesai

Verifikasi apakah peluncuran update selesai dengan memeriksa nilai kolom status.versionTarget.isReached MIG:

• status.versionTarget.isReached yang disetel ke true menunjukkan bahwa semua instance VM telah atau sedang dibuat menggunakan versi target.

• status.versionTarget.isReached yang disetel ke false menunjukkan bahwa setidaknya satu VM belum menggunakan versi target. Atau, dalam kasus update canary, false menunjukkan bahwa jumlah VM yang menggunakan versi target tidak cocok dengan ukuran targetnya.

Catatan: Untuk memverifikasi bahwa peluncuran update telah selesai dan semua instance VM dalam grup berjalan dan responsif, periksa flag status.isStable dan status.versionTarget.isReached.

Memeriksa apakah grup instance terkelola stabil

Pastikan semua instance dalam grup instance terkelola berjalan dan responsif dengan memeriksa nilai kolom status.isStable grup.

status.isStable yang disetel ke false menunjukkan bahwa perubahan aktif, tertunda, atau MIG itu sendiri sedang diubah.

status.isStable yang ditetapkan ke true menunjukkan hal berikut:

• Tidak ada instance di MIG yang mengalami jenis perubahan apa pun dan currentAction untuk semua instance adalah NONE.
• Tidak ada perubahan yang tertunda untuk instance di MIG.
• MIG itu sendiri tidak dimodifikasi.

Ingatlah bahwa stabilitas MIG bergantung pada banyak faktor, karena MIG dapat dimodifikasi dengan berbagai cara. Contoh:

• Anda membuat permintaan untuk meluncurkan template instance baru.
• Anda membuat permintaan untuk membuat, menghapus, mengubah ukuran, atau memperbarui instance di MIG.
• Autoscaler meminta untuk mengubah ukuran MIG.
• Resource autohealer menggantikan satu atau beberapa instance yang tidak responsif di MIG.
• Pada MIG regional, beberapa instance sedang didistribusikan ulang.

Segera setelah semua tindakan selesai, status.isStable disetel ke true lagi untuk MIG tersebut.

Tindakan saat ini pada instance

Gunakan Google Cloud CLI atau REST untuk melihat detail tentang instance dalam grup instance terkelola. Detail mencakup status instance dan tindakan saat ini yang dilakukan grup pada instance-nya.

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut:

• compute.instanceGroupManagers.get di grup
• compute.instanceGroupManagers.list di grup

gcloud

Semua instance terkelola

Untuk memeriksa status dan tindakan saat ini pada semua instance dalam grup, gunakan perintah list-instances.

gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
    [--zone=ZONE | --region=REGION]

Perintah ini menampilkan daftar instance dalam grup, termasuk statusnya, tindakan saat ini, dan detail lainnya:

NAME               ZONE           STATUS   HEALTH_STATE  ACTION  INSTANCE_TEMPLATE  VERSION_NAME  LAST_ERROR
vm-instances-9pk4  us-central1-f                          CREATING  my-new-template
vm-instances-h2r1  us-central1-f  STOPPING                DELETING  my-old-template
vm-instances-j1h8  us-central1-f  RUNNING                 NONE      my-old-template
vm-instances-ngod  us-central1-f  RUNNING                 NONE      my-old-template

Kolom HEALTH_STATE akan tampak kosong kecuali jika Anda telah menyiapkan health check.

Instance terkelola tertentu

Untuk memeriksa status dan tindakan saat ini untuk instance tertentu dalam grup, gunakan perintah describe-instance.

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

Perintah ini menampilkan detail tentang instance, termasuk status instance, tindakan saat ini, dan, untuk MIG stateful, status yang dipertahankan:

currentAction: NONE
id: '6789072894767812345'
instance: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-mig-hz41
instanceStatus: RUNNING
name: example-mig-hz41
preservedStateFromConfig:
  metadata:
    example-key: example-value
preservedStateFromPolicy:
  disks:
    persistent-disk-0:
      autoDelete: NEVER
      mode: READ_WRITE
      source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-mig-hz41
version:
  instanceTemplate: https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template

REST

Panggil metode listManagedInstances pada resource miG regional atau zonal. Misalnya, untuk melihat detail tentang instance dalam resource MIG zona, Anda dapat membuat permintaan berikut:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

Panggilan ini menampilkan daftar instance untuk MIG termasuk instanceStatus dan currentAction setiap instance.

{
 "managedInstances": [
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-prvp",
   "id": "5317605642920955957",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-pz5j",
   "currentAction": "DELETING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-w2t5",
   "id": "2800161036826218547",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  }
 ]
}

Untuk melihat daftar nilai kolom instanceStatus yang valid, lihat Siklus proses instance VM.

Jika instance mengalami beberapa jenis perubahan, grup instance terkelola akan menetapkan kolom currentAction instance ke salah satu tindakan berikut untuk membantu Anda melacak progres perubahan tersebut. Jika tidak, kolom currentAction akan ditetapkan ke NONE.

Nilai currentAction yang mungkin adalah:

• ABANDONING. Instance sedang dihapus dari MIG.
• CREATING. Instance sedang dalam proses dibuat.
• CREATING_WITHOUT_RETRIES. Instance sedang dibuat tanpa percobaan ulang; jika instance tidak dibuat pada percobaan pertama, MIG tidak akan mencoba mengganti instance lagi.
• DELETING. Instance sedang dalam proses dihapus.
• RECREATING. Instance sedang diganti.
• REFRESHING. Instance dihapus dari kumpulan targetnya saat ini dan ditambahkan kembali ke daftar kumpulan target saat ini (daftar ini mungkin sama atau berbeda dari kumpulan target yang ada).
• RESTARTING. Instance sedang dalam proses dimulai ulang menggunakan metode stop dan start.
• RESUMING. Instance sedang dalam proses dilanjutkan setelah ditangguhkan.
• STARTING. Instance ini sedang dalam proses dimulai setelah dihentikan.
• STOPPING. Instance sedang dihentikan.
• SUSPENDING. Instance sedang ditangguhkan.
• VERIFYING. Instance telah dibuat dan sedang dalam proses diverifikasi.
• NONE. Tidak ada tindakan yang dilakukan pada instance.

Catatan: Kolom pendingActions tidak digunakan lagi dan akan dihapus. Hubungi [e-mail] untuk memberikan masukan jika workload Anda bergantung pada kolom ini.

Me-roll back update

Tidak ada perintah eksplisit untuk me-roll back update ke versi sebelumnya, tetapi jika Anda memutuskan untuk me-roll back update (baik update yang di-commit penuh maupun update terbatas), Anda dapat melakukannya dengan membuat permintaan update baru dan meneruskan template instance tempat Anda ingin melakukan roll back.

gcloud

Misalnya, perintah gcloud CLI berikut me-roll back update secepat mungkin. Ganti OLD_INSTANCE_TEMPLATE dengan nama template instance yang ingin Anda roll back.

gcloud compute instance-groups managed rolling-action start-update INSTANCE_GROUP_NAME \
    --version=template=OLD_INSTANCE_TEMPLATE_NAME \
    --max-unavailable=100% \
    [--zone=ZONE | --region=REGION]

REST

Panggil metode patch pada resource miG regional atau zonal.

Di isi permintaan, tentukan template instance sebelumnya sebagai version:

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

{
  "updatePolicy":
  {
    "maxUnavailable":
    {
      "percent": 100
    }
  },
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/OLD_INSTANCE_TEMPLATE_NAME" # Old instance template
    }
  ]
}

Untuk MIG regional dengan kurang dari 10 instance, Anda harus menggunakan nilai tetap untuk maxUnavailable dan menyetel nilai ke jumlah instance dalam grup.

Updater memperlakukan permintaan rollback sama seperti permintaan update reguler, sehingga Anda dapat menentukan opsi update tambahan.

Perhatian: Untuk update canary, sebaiknya roll back update canary sepenuhnya sebelum Anda mencoba canary versi lain. Tidak ada cara untuk memilih instance mana yang diupdate secara selektif berdasarkan template instance mana, dan menjalankan update canary lainnya selain update yang ada dapat menyebabkan konsekuensi yang tidak diinginkan. Sebagai praktik terbaik, Anda harus melakukan roll back update canary sepenuhnya terlebih dahulu dan memulai ulang proses canary lagi dari awal.

Menghentikan update

Tidak ada metode atau perintah eksplisit untuk menghentikan update. Anda dapat mengubah update dari proaktif menjadi oportunistik, dan jika ukuran grup tidak diubah oleh layanan lain seperti autoscaler, perubahan ke oportunistik akan secara efektif menghentikan update.

Untuk mengubah update dari proaktif ke oportunistik dengan menggunakan gcloud CLI, jalankan perintah berikut:

gcloud compute instance-groups managed rolling-action stop-proactive-update INSTANCE_GROUP_NAME \
    [--zone=ZONE | --region=REGION]

Untuk menghentikan update sepenuhnya setelah mengonversinya dari proaktif menjadi oportunistik, ikuti langkah-langkah berikut:

1. Buat permintaan untuk menentukan jumlah instance yang telah diupdate:

   gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
      [--zone=ZONE | --region=REGION]

   Gcloud CLI menampilkan respons yang menyertakan daftar instance dalam grup dan statusnya saat ini:

   NAME               ZONE           STATUS   HEALTH_STATE  ACTION    INSTANCE_TEMPLATE  VERSION_NAME  LAST_ERROR
   vm-instances-9pk4  us-central1-f  RUNNING  HEALTHY       NONE      example-new-template
   vm-instances-j1h8  us-central1-f  RUNNING  HEALTHY       NONE      example-old-template
   vm-instances-ngod  us-central1-f  STAGING  UNKNOWN       CREATING  example-new-template
   

   Dalam contoh ini, dua instance telah diupdate.

2. Selanjutnya, buat permintaan untuk menjalankan update baru, tetapi teruskan jumlah instance yang telah diupdate sebagai ukuran target:

   gcloud compute instance-groups managed rolling-action start-update INSTANCE_GROUP_NAME \
      --version template=OLD_INSTANCE_TEMPLATE_NAME \
      --canary-version template=NEW_INSTANCE_TEMPLATE_NAME,target-size=2 \
      [--zone=ZONE | --region=REGION]

   Bagi Updater, update ini tampak selesai, sehingga tidak ada instance lain yang diupdate, sehingga menghentikan update secara efektif.

Mengontrol kecepatan update berkelanjutan

Secara default, saat Anda membuat permintaan update, Updater akan menjalankan update secepat mungkin. Jika tidak yakin ingin menerapkan update sepenuhnya atau sedang menguji perubahan untuk sementara, Anda dapat mengontrol kecepatan update menggunakan metode berikut.

1. Mulai update canary, bukan update penuh.
2. Setel nilai minReadySec yang besar. Menyetel nilai ini akan membuat Updater menunggu selama jumlah detik ini sebelum menganggap instance berhasil diupdate dan melanjutkan ke instance berikutnya.
3. Aktifkan health check agar Updater menunggu aplikasi Anda dimulai dan melaporkan sinyal responsif sebelum menganggap instance berhasil diupdate dan dilanjutkan ke instance berikutnya.
4. Setel nilai maxUnavailable dan maxSurge yang rendah. Hal ini memastikan bahwa hanya ada sedikit instance yang diperbarui pada satu waktu.
5. Update instance secara selektif di MIG, bukan menggunakan update otomatis.

Anda juga dapat menggunakan kombinasi metode ini untuk mengontrol kecepatan update.

Mengontrol tingkat gangguan selama pembaruan berkelanjutan

Bergantung pada sifat update, update dapat mengganggu status siklus proses instance. Misalnya, perubahan boot disk instance memerlukan penggantian instance. Anda dapat mengontrol tingkat gangguan selama update berkelanjutan dengan menyetel opsi berikut:

• Tindakan minimal: Gunakan opsi ini untuk meminimalkan gangguan sebanyak mungkin atau untuk menerapkan tindakan yang lebih mengganggu daripada yang diperlukan.

  • Untuk membatasi gangguan sebanyak mungkin, setel tindakan minimal ke REFRESH. Jika update Anda memerlukan tindakan yang lebih mengganggu, Compute Engine akan melakukan tindakan yang diperlukan untuk menjalankan update tersebut.
  • Untuk menerapkan tindakan yang lebih mengganggu daripada yang seharusnya, setel tindakan minimal ke RESTART atau REPLACE. Misalnya, Compute Engine tidak perlu memulai ulang VM untuk mengubah metadatanya. Namun, jika aplikasi Anda hanya membaca metadata instance saat VM dimulai ulang, Anda dapat menyetel tindakan minimal ke RESTART untuk mengambil perubahan metadata.

• Tindakan paling mengganggu yang diizinkan: Gunakan opsi ini untuk mencegah update jika memerlukan gangguan lebih besar dari yang Anda mampu. Jika update memerlukan tindakan yang lebih mengganggu daripada yang Anda setel dengan flag ini, permintaan update akan gagal. Misalnya, jika Anda menyetel tindakan paling mengganggu yang diizinkan ke RESTART, upaya untuk mengupdate boot disk image akan gagal karena update tersebut memerlukan penggantian instance, tindakan yang lebih mengganggu daripada mulai ulang.

Kedua opsi ini menerima nilai berikut:

Nilai	Deskripsi	Properti instance mana yang dapat diupdate?
REFRESH	Jangan hentikan instance.	Disk tambahan, metadata instance, label, tag
RESTART	Hentikan instance dan mulai lagi.	Disk tambahan, metadata instance, label, tag, jenis mesin
REPLACE	(Default.) Ganti instance sesuai dengan opsi metode penggantian.	Semua properti instance yang disimpan dalam template instance atau konfigurasi per instance

Tindakan paling mengganggu yang diizinkan tidak boleh lebih mengganggu daripada tindakan minimal.

Jika Anda meluncurkan update secara otomatis, setelan default berikut akan berlaku:

• Tindakan minimal default adalah REPLACE. Jika Anda ingin mencegah gangguan yang tidak perlu, setel tindakan minimal agar tidak terlalu mengganggu.
• Tindakan default paling mengganggu yang diizinkan adalah REPLACE. Jika Anda tidak dapat menoleransi gangguan tersebut, setel tindakan paling mengganggu yang diizinkan agar tidak terlalu mengganggu.

Anda dapat mengubah perilaku default ini dengan menggunakan Compute Engine API untuk menyetel kolom updatePolicy.minimalAction dan updatePolicy.mostDisruptiveAllowedAction dalam resource MIG Anda–misalnya, dengan memanggil metode regionInstanceGroupManagers.patch. Atau, Anda dapat memilih Tindakan yang diizinkan untuk mengupdate VM tertentu saat Anda mengupdate MIG dari konsol Google Cloud. Untuk melihat setelan saat ini, baca Mendapatkan properti MIG.

Update gagal jika memerlukan tindakan yang lebih mengganggu dari yang Anda izinkan. Jika hal ini terjadi, Anda dapat mencoba update lagi dengan tindakan lebih mengganggu yang diizinkan, atau Anda dapat mengupdate instance secara selektif. Compute Engine melakukan validasi upaya terbaik untuk melihat apakah instance dapat diupdate dengan batas gangguan yang ditentukan. Namun, karena perubahan serentak dalam sistem, situasinya dapat berubah setelah update dimulai. Jika operasi pada instance tertentu gagal, cantumkan error instance untuk melihat error tersebut.

Menjalankan penggantian berkelanjutan atau memulai ulang

Mulai ulang berkelanjutan akan menghentikan dan memulai ulang semua instance, sedangkan penggantian berkelanjutan akan menggantikan instance sesuai dengan opsi metode penggantian. Mulai ulang atau penggantian berkelanjutan tidak mengubah apa pun pada grup, termasuk template instance.

Ada banyak alasan mengapa Anda mungkin menginginkan mulai ulang berkelanjutan atau penggantian berkelanjutan. Misalnya, Anda mungkin ingin memulai ulang atau mengganti instance VM dari waktu ke waktu karena salah satu alasan berikut:

• Menghapus kebocoran memori.
• Memulai ulang aplikasi agar dapat berjalan dari komputer baru.
• Menerapkan penggantian berkala sebagai praktik terbaik untuk menguji VM Anda.
• Mengupdate image sistem operasi VM atau menjalankan kembali skrip startup untuk mengupdate software Anda.

Gunakan Konsol Google Cloud, Google Cloud CLI, atau REST untuk melakukan mulai ulang atau mengganti.

Konsol

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

   Buka Instance groups

2. Pilih grup instance terkelola yang memiliki VM yang ingin Anda mulai ulang atau ganti.
3. Klik Restart/replace VMs.
4. Di bagian Operation, pilih Restart atau Replace.
   • Jika Anda memilih Restart, aktifkan parameter berikut:
     • Instance tidak tersedia maksimum
     • Waktu tunggu minimum
   • Jika Anda memilih Replace, lakukan tindakan berikut:
     1. Pilih apakah Anda ingin mempertahankan nama instance saat mengganti instance.
     2. Ubah parameter berikut:
        • Instance tambahan sementara
        • Instance tidak tersedia maksimum
        • Waktu tunggu minimum
5. Untuk memulai operasi, klik Restart VMs atau Replace VMs.

gcloud

Gunakan perintah restart atau perintah replace.

Perintah berikut mengganti semua instance di MIG, satu per satu:

gcloud compute instance-groups managed rolling-action replace INSTANCE_GROUP_NAME

Perintah berikut akan memulai ulang setiap instance, satu per satu:

gcloud compute instance-groups managed rolling-action restart INSTANCE_GROUP_NAME

Anda dapat menyesuaikan lebih lanjut setiap perintah ini dengan opsi yang sama yang tersedia untuk update (misalnya, maxSurge dan maxUnavailable).

REST

Panggil metode patch pada resource miG regional atau zonal.

Di kolom updatePolicy.minimalAction, tentukan RESTART atau REPLACE. Di kolom versions.instanceTemplate, tentukan template saat ini.

Untuk memicu tindakan, Anda juga harus memperbarui kolom versions.name—misalnya, dengan menambahkannya dengan stempel waktu. Kemudian, Anda dapat mencantumkan VM MIG dan memeriksa kolom versions.name setiap VM untuk menentukan VM mana yang telah diganti atau dimulai ulang.

Misalnya, untuk MIG zona, permintaan berikut menunjukkan konfigurasi minimal yang diperlukan untuk memulai ulang 100% instance secara otomatis.

PATCH https://compute.googleapis.com/compute/v1/projects/example-project/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME

{
 "updatePolicy": {
  "minimalAction": "RESTART",
  "type": "PROACTIVE"
 },
 "versions": [
  {
   "instanceTemplate": "global/instanceTemplates/CURRENT_INSTANCE_TEMPLATE_NAME",
   "name": "v2-1705499403"
  }
 ]
}

Contoh penggantian/mulai ulang tambahan

Jalankan mulai ulang berkelanjutan pada semua VM, dua sekaligus

Perintah ini akan memulai ulang semua VM dalam grup, dua sekaligus. Perhatikan bahwa tidak ada template instance baru yang ditentukan.

gcloud compute instance-groups managed rolling-action restart INSTANCE_GROUP_NAME \
    --max-unavailable=2 \
    [--zone=ZONE | --region=REGION]

Jalankan mulai ulang berkelanjutan pada semua VM secepat mungkin

gcloud compute instance-groups managed rolling-action restart INSTANCE_GROUP_NAME \
    --max-unavailable=100% \
    [--zone=ZONE | --region=REGION]

Jalankan penggantian berkelanjutan pada semua VM secepat mungkin

gcloud compute instance-groups managed rolling-action replace INSTANCE_GROUP_NAME  \
    --max-unavailable=100% \
    [--zone=ZONE | --region=REGION]

Mempertahankan nama instance

Jika Anda perlu mempertahankan nama instance VM saat terjadi update, setel replacementMethod ke RECREATE. Anda juga harus menyetel maxUnavailable ke lebih besar dari 0 dan maxSurge ke 0. Membuat ulang instance dan bukan menggantinya akan menyebabkan penyelesaian update Anda memakan waktu lebih lama, tetapi instance yang diupdate akan tetap mempertahankan namanya.

Jika Anda tidak menentukan metode penggantian, nilai updatePolicy.replacementMethod MIG saat ini akan digunakan. Jika tidak disetel, nilai default substitute akan digunakan, yang menggantikan instance VM dengan instance baru yang memiliki nama yang dibuat secara acak.

gcloud

Saat mengeluarkan perintah rolling-action, sertakan flag --replacement-method=recreate.

gcloud compute instance-groups managed rolling-action start-update INSTANCE_GROUP_NAME \
    --replacement-method=recreate \
    --version=template=NEW_TEMPLATE \
    --max-unavailable=5 \
    [--zone=ZONE | --region=REGION]

REST

Panggil metode patch pada resource miG regional atau zonal. Di isi permintaan, sertakan kolom updatePolicy.replacementMethod:

PATCH /compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME
{
    "updatePolicy": {
        "type": "PROACTIVE",
        "maxUnavailable": { "fixed": 5 },
        "replacementMethod": "RECREATE"
    },
    "versions": [ {
        "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE"
    } ]
}

Setelah membuat permintaan, Anda dapat memantau update untuk mengetahui kapan update selesai.

Memperbarui grup instance terkelola regional

MIG regional berisi beberapa instance VM yang tersebar di beberapa zona dalam satu region, berbeda dengan MIG zona, yang hanya berisi beberapa instance dalam satu zona. Dengan MIG regional, Anda dapat mendistribusikan instance di lebih dari satu zona untuk meningkatkan ketersediaan aplikasi dan untuk mendukung kasus ekstrem saat satu zona gagal atau seluruh grup instance berhenti merespons.

Menjalankan update pada MIG regional sama dengan melakukan update pada MIG zona, dengan beberapa pengecualian yang dijelaskan di bawah ini. Saat Anda memulai update ke MIG regional, Updater akan selalu mengupdate instance secara proporsional dan merata di setiap zona. Anda tidak dapat memilih instance di zona mana yang akan diupdate terlebih dahulu dan Anda tidak dapat memilih untuk mengupdate instance hanya dalam satu zona.

Perbedaan antara mengupdate MIG regional versus zona

MIG regional memiliki nilai update default berikut:

• maxUnavailable=NUMBER_OF_ZONES
• maxSurge=NUMBER_OF_ZONES

NUMBER_OF_ZONES adalah jumlah zona yang terkait dengan MIG regional. Secara default, jumlah zona untuk MIG regional adalah 3. Namun Anda dapat memilih angka lain.

Jika Anda menggunakan angka tetap saat menentukan update, angka tetapnya harus 0 atau sama dengan atau lebih besar dari jumlah zona yang terkait dengan MIG regional. Misalnya, jika grup didistribusikan di tiga zona, Anda tidak dapat menyetel maxSurge ke 1 atau 2 karena Updater harus membuat instance tambahan di setiap zona dari tiga zona.

Menggunakan angka tetap atau persentase dalam permintaan update

Jika Anda menentukan angka tetap dalam permintaan update, jumlah yang Anda tentukan akan dibagi dengan jumlah zona di MIG regional dan didistribusikan secara merata. Misalnya, jika Anda menentukan maxSurge=10, Updater akan membagi 10 di jumlah zona dalam region dan membuat instance berdasarkan angka tersebut. Jika jumlah instance tidak dibagi secara merata di seluruh zona, Updater akan menambahkan instance lainnya ke zona acak. Jadi, untuk 10 instance di tiga zona, dua zona mendapatkan 3 instance dan satu zona mendapatkan 4 instance. Logika yang sama diterapkan pada parameter maxUnavailable dan targetSize untuk update canary.

Anda dapat menentukan persentase hanya jika MIG Anda berisi 10 instance VM atau lebih. Persentase ditangani sedikit berbeda tergantung situasinya:

• Jika Anda menentukan persentase instance VM untuk update canary, Updater akan mencoba mendistribusikan instance secara merata di seluruh zona. Sisanya akan dibulatkan ke atas atau ke bawah di setiap zona, tetapi selisih totalnya tidak lebih dari 1 instance VM per grup. Misalnya, untuk MIG dengan 10 instance dan persentase ukuran target sebesar 25%, update diluncurkan ke 2 hingga 3 instance VM.

• Jika Anda menentukan persentase untuk opsi update seperti maxSurge dan maxUnavailable, persentase akan dibulatkan secara independen per zona.

Langkah selanjutnya

• Pelajari cara Melihat info tentang MIG dan instance terkelola.
• Pelajari cara Membuat template instance.
• Pelajari cara menggunakan kelompok image dan penggantian berkelanjutan untuk mengupdate image OS pada semua VM di MIG.