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.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi 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. After installing the Google Cloud CLI, initialize it by running the following command:

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      2. Set a default region and zone.
      3. REST

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

          After installing the Google Cloud CLI, initialize it by running the following command:

          gcloud init

          If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

        Untuk mengetahui 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_URL_ \
    --size SIZE \
    --force-update-on-repair

Ganti kode berikut:

  • MIG_NAME: Nama grup instance.
  • INSTANCE_TEMPLATE_URL: URL template instance yang ingin Anda gunakan untuk membuat VM 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
  • 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_URL",
  "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_URL: URL template instance yang ingin Anda gunakan untuk membuat VM 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
  • 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 VM diperbaiki.
  • YES: MIG mengupdate VM selama perbaikannya.

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 VM diperbaiki.
  • YES: MIG mengupdate VM selama perbaikannya.

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