Mengganti properti template instance dengan konfigurasi semua instance


Halaman ini menjelaskan cara menggunakan konfigurasi semua instance untuk menetapkan properti label dan metadata untuk semua instance virtual machine (VM) di grup instance terkelola (MIG) tanpa perlu membuat template instance baru.

Anda dapat terus menggunakan template instance untuk menetapkan properti instance di MIG. Namun, penggunaan konfigurasi semua instance MIG lebih mudah dalam beberapa skenario, seperti berikut:

  • Anda harus mengupdate metadata atau label instance secara rutin dan tanpa overhead untuk membuat template baru setiap saat. Ingat bahwa template instance tidak dapat diubah, yang berarti template instance tidak dapat diubah setelah dibuat.

  • Anda ingin memiliki beberapa MIG berdasarkan satu template instance, tetapi Anda perlu mengonfigurasi label atau metadata untuk setiap MIG secara berbeda. Misalnya, jika Anda memiliki satu aplikasi, tetapi ingin mendukung lingkungan yang berbeda untuk pengembangan, pengujian, dan produksi. Anda dapat membuat satu template instance dan menggunakannya kembali untuk semua lingkungan dengan menetapkan metadata yang berbeda dengan konfigurasi semua instance yang berbeda untuk setiap lingkungan.

  • Anda mempunyai satu tim yang memiliki infrastruktur dan image, sementara tim lain menjalankan aplikasi yang memerlukan konfigurasi. Anda dapat memiliki satu tim penyediaan infrastruktur dengan satu template instance, sementara tim aplikasi dapat mengelola konfigurasi aplikasi dengan konfigurasi semua instance.

  • Anda memiliki agen yang berjalan di VM dan Anda ingin mengonfigurasinya menggunakan metadata. Anda ingin memastikan konfigurasi agen VM tetap ada bahkan setelah template instance grup berubah. Gunakan template instance untuk mengontrol versi aplikasi dan mengonfigurasi agen VM menggunakan konfigurasi semua instance.

Jika Anda menetapkan properti yang sama menggunakan template instance MIG dan konfigurasi semua instance-nya, MIG akan memprioritaskan nilai dari konfigurasi semua instance. Misalnya, jika metadata untuk enable-guest-attributes ditetapkan ke FALSE dalam template instance MIG dan TRUE dalam konfigurasi semua instance MIG, Compute Engine akan diterapkan TRUE pada semua instance dalam grup itu. Hal ini memungkinkan Anda menggunakan konfigurasi semua instance untuk mengganti properti yang ditentukan dalam template instance.

Sebelum memulai

  • Membuat grup instance terkelola.
  • 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
    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.

        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.

Batasan

  • Anda hanya dapat mengganti properti template instance berikut dengan konfigurasi semua instance:

    • Metadata
    • Label
  • Anda tidak dapat melakukan update canary pada konfigurasi semua instance. Saat Anda menerapkan konfigurasi ke grup, Compute Engine akan menerapkan properti ke semua instance baru, dan ke instance yang ada berdasarkan kebijakan update Anda. Jika ingin mengontrol instance mana yang akan diupdate, kapan Anda dapat menggunakan update selektif.

  • Jika menggunakan konfigurasi stateful di MIG, Anda tidak dapat menetapkan properti yang sama dalam konfigurasi per instance apa pun dan pada saat yang sama dalam konfigurasi semua instance grup.

Menetapkan properti dalam konfigurasi semua instance

Membuat dan mengupdate konfigurasi semua instance MIG menggunakan gcloud CLI atau REST.

Konsol

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

    Buka Instance groups

  2. Pilih MIG yang konfigurasi semua instance-nya ingin Anda tetapkan.

  3. Klik Update VMs.

  4. Di bagian All-instances configuration, lakukan hal berikut:

    • Untuk menambahkan atau memperbarui nilai metadata, klik Kelola metadata. Selesaikan penyiapan dan klik Simpan.
    • Untuk menambahkan atau memperbarui label, klik Kelola label. Selesaikan penyiapan, lalu klik Simpan.
  5. Setelah Anda selesai menyiapkan properti dalam konfigurasi semua instance, klik Update VMs.

    Jika jenis update MIG ditetapkan ke Otomatis, konfigurasi semua instance yang Anda tetapkan akan langsung diterapkan ke semua VM yang ada. Jika jenis updatenya adalah Selektif, Anda harus menerapkan konfigurasi secara selektif ke VM yang ada. Untuk mengetahui informasi selengkapnya, lihat Menerapkan konfigurasi semua instance ke VM yang ada.

gcloud

Tambahkan atau perbarui konfigurasi semua instance dengan menggunakan perintah all-instances-config update.

gcloud compute instance-groups managed all-instances-config update INSTANCE_GROUP_NAME \
    --metadata=KEY1=VALUE1,KEY2=VALUE2 \
    --labels=KEY3=VALUE3,KEY4=VALUE4

Ganti kode berikut:

  • INSTANCE_GROUP_NAME: nama MIG.
  • KEYS dan VALUES: pasangan nilai kunci untuk label atau metadata. Jika kunci tidak ada, maka perintah update akan menambahkannya. Untuk kunci yang sudah ada, nilainya akan diperbarui.

Jangan lupa menerapkan konfigurasi terbaru ke VM yang ada di MIG.

REST

Tambahkan atau perbarui konfigurasi semua instance dengan membuat permintaan PATCH pada MIG tingkat zona atau regional.

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

{
  "allInstancesConfig": {
    "properties": {
      "metadata": {
        "KEY1": "VALUE1",
        ...
      },
      "labels": {
        "KEY2": "VALUE2",
        ...
      },
    }
  }
}

Ganti kode berikut:

  • PROJECT_ID: project tempat MIG berada.
  • REGION: region tempat MIG Anda berada. Untuk MIG tingkat zona, ganti regions/REGION dengan zones/ZONE.
  • INSTANCE_GROUP_NAME: nama MIG.
  • KEYS dan VALUES: pasangan nilai kunci untuk label atau metadata. Jika kunci tidak ada, permintaan akan menambahkannya. Untuk kunci yang sudah ada, nilainya akan diperbarui.

Jangan lupa menerapkan konfigurasi terbaru ke VM yang ada di MIG.

Menerapkan konfigurasi semua instance ke VM yang ada

Konfigurasi VM yang Anda tentukan untuk VM dalam MIG otomatis diterapkan ke VM baru yang ditambahkan ke grup.

Untuk menerapkan konfigurasi VM yang telah diupdate, termasuk konfigurasi semua instance yang telah diupdate ke VM yang ada dalam grup, gunakan salah satu metode berikut:

  • Otomatis (proaktif): Gunakan metode ini jika Anda ingin MIG menerapkan konfigurasi baru secara otomatis ke semua atau subset VM yang ada dalam grup. Tingkat gangguan pada VM yang berjalan bergantung pada kebijakan update yang Anda konfigurasikan. Anda dapat menggunakan metode ini untuk melakukan update canary pada template instance baru. Untuk menggunakan metode ini, setel jenis update MIG ke "proactive".
  • Selektif (oportunistik): Gunakan metode ini jika Anda ingin menerapkan update secara manual, atau jika ingin mengupdate semua VM yang ada di grup sekaligus. Anda akan menargetkan setiap atau semua VM untuk diupdate ke konfigurasi terbaru. Untuk menggunakan metode ini, tetapkan jenis update MIG ke "opportunistic".
  • Pembuatan ulang VM: Saat Anda membuat ulang VM di MIG, MIG akan menerapkan setiap konfigurasi terbaru yang belum diterapkan ke VM tersebut. Untuk mengetahui informasi selengkapnya, lihat Membuat ulang VM di MIG.

Otomatis (proaktif)

Jika Anda ingin menerapkan konfigurasi semua instance yang telah diperbarui secara otomatis ke semua VM yang ada setiap kali Anda membuat perubahan, tetapkan jenis kebijakan update grup ke "proaktif". Untuk informasi selengkapnya, lihat Jenis update otomatis (proaktif).

Anda dapat mengontrol kecepatan peluncuran konfigurasi proaktif menggunakan setelan maxUnavailable, maxSurge, dan minReadySec opsional.

Untuk menggunakan update proaktif, Anda hanya perlu mengonfigurasinya sekali. Setelah itu, MIG akan menerapkan semua perubahan konfigurasi VM mendatang (yaitu, perubahan pada konfigurasi semua instance, template instance, dan konfigurasi per instance grup) secara otomatis ke semua VM dalam grup berbasis pada setelan dalam kebijakan pembaruan grup.

Untuk menerapkan update konfigurasi secara otomatis, gunakan gcloud CLI atau REST.

gcloud

Anda dapat mengonfigurasi update otomatis (proaktif) menggunakan perintah update.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --update-policy-type=proactive \
    --update-policy-max-unavailable=MAX_UNAVAILABLE \
    --update-policy-max-surge=MAX_SURGE \
    --update-policy-min-ready=MIN_READY \
    --update-policy-minimal-action=MINIMAL_ACTION \
    --update-policy-replacement-method=REPLACEMENT_METHOD

Ganti kode berikut:

  • INSTANCE_GROUP_NAME: nama MIG.
  • MAX_UNAVAILABLE (opsional): jumlah maksimum instance yang tidak tersedia selama update. Misalnya, jika Anda menetapkan flag update-minimal-action ke restart, flag ini akan membatasi jumlah VM yang dimulai ulang pada satu waktu. Flag ini dapat berupa angka tetap (misalnya, 5) atau persentase ukuran untuk grup instance terkelola (misalnya, 10%).
  • MAX_SURGE (opsional): jumlah maksimum instance tambahan yang dapat dibuat selama update. Flag ini dapat berupa angka tetap (misalnya, 5) atau persentase ukuran untuk grup instance terkelola (misalnya, 10%).
  • MIN_READY (opsional): waktu minimum saat VM yang dimulai ulang atau diganti harus siap agar dianggap tersedia. Misalnya, 10s selama 10 detik. Lihat tanggal waktu topik gcloud untuk mengetahui informasi tentang format durasi.
  • MINIMAL_ACTION (opsional): tindakan yang akan dilakukan pada setiap instance selama pembaruan konfigurasi:
    • refresh: menerapkan konfigurasi baru pada instance yang sedang berjalan tanpa memulai ulang.
    • restart: memulai ulang VM selama update, yang berguna jika aplikasi Anda hanya membaca metadata selama proses mulai ulang.
    • replace: menghapus VM dan membuat VM baru untuk menerapkan konfigurasi baru.
  • REPLACEMENT_METHOD (opsional): menentukan tindakan yang digunakan untuk mengganti instance:
    • recreate: menunggu instance lama dihapus, lalu membuat instance baru dengan nama yang sama seperti instance lama.
    • substitute: membuat instance dengan nama baru saat menghapus instance lama

REST

Anda dapat mengonfigurasi update otomatis (proaktif) dengan membuat permintaan PATCH di MIG tingkat zona atau regional.

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

{
  "updatePolicy": {
    "type": "PROACTIVE",
    "maxUnavailable": {
      "percent": MAX_UNAVAILABLE
    },
    "maxSurge": {
      "percent": MAX_SURGE
    },
    "minimalAction": MINIMAL_ACTION,
    "replacementMethod": REPLACEMENT_METHOD
  }
}

Ganti kode berikut:

  • PROJECT_ID: project tempat MIG berada.
  • REGION: region tempat MIG Anda berada. Untuk MIG tingkat zona, ganti regions/REGION dengan zones/ZONE.
  • INSTANCE_GROUP_NAME: nama MIG.
  • MAX_UNAVAILABLE (opsional): jumlah maksimum instance yang tidak tersedia selama update. Misalnya, jika Anda menetapkan flag update-minimal-action ke RESTART, flag ini akan membatasi jumlah VM yang dimulai ulang pada satu waktu. Flag ini dapat berupa persentase (misalnya, menentukan "percent": 80 untuk 80%) atau angka tetap. Untuk menentukan angka tetap, ganti "percent": MAX_UNAVAILABLE dengan "fixed": MAX_UNAVAILABLE.
  • MAX_SURGE (opsional): jumlah maksimum instance tambahan yang dapat dibuat selama update. Flag ini bisa berupa persentase atau angka tetap.
  • MINIMAL_ACTION (opsional): tindakan yang akan dilakukan pada setiap instance selama pembaruan konfigurasi:
    • REFRESH: menerapkan konfigurasi baru pada instance yang sedang berjalan tanpa memulai ulang.
    • RESTART: memulai ulang VM selama update, yang berguna jika aplikasi Anda hanya membaca metadata selama proses mulai ulang.
    • REPLACE: menghapus VM dan membuat VM baru untuk menerapkan konfigurasi baru.
  • REPLACEMENT_METHOD (opsional): menentukan tindakan yang digunakan untuk mengganti instance:
    • RECREATE: menunggu instance lama dihapus, lalu membuat instance baru dengan nama yang sama seperti instance lama.
    • SUBSTITUTE: membuat instance dengan nama baru saat menghapus instance lama

Jika flag opsional dihilangkan, grup akan menggunakan nilai dalam kebijakan update grup. Anda dapat memeriksa kebijakan update menggunakan gcloud CLI atau REST.

Selektif (oportunistik)

Jika Anda ingin mengontrol kapan dan di mana VM akan diterapkan konfigurasi baru, tetapkan jenis kebijakan update grup ke "opportunistic". Untuk mengetahui informasi selengkapnya, lihat Jenis update selektif (oportunistik).

Saat Anda memilih untuk menerapkan update konfigurasi secara selektif, setiap perubahan pada konfigurasi semua instance grup, template instance, atau konfigurasi per instance tidak akan diterapkan ke VM yang ada secara otomatis. Anda harus secara eksplisit menerapkan konfigurasi yang diupdate ke VM yang ada untuk mengupdatenya.

Untuk menerapkan update konfigurasi VM secara selektif ke VM di MIG, gunakan gcloud CLI atau REST.

gcloud

Anda dapat mengonfigurasi update selektif (oportunistik) menggunakan perintah update:

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --update-policy-type=opportunistic

Jika Anda menetapkan jenis update grup ke opportunistic, Anda harus memulai update saat ingin menerapkan konfigurasi baru ke VM yang ada.

Menerapkan konfigurasi ke VM tertentu

Untuk memperbarui instance yang dipilih, gunakan perintah berikut:

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAMES \
    --minimal-action=MINIMAL_ACTION \
    --most-disruptive-allowed-action=MOST_DISRUPTIVE_ALLOWED_ACTION

Menerapkan konfigurasi ke semua VM

Untuk memperbarui semua instance yang ada, gunakan perintah berikut:

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --all-instances \
    --minimal-action=MINIMAL_ACTION \
    --most-disruptive-allowed-action=MOST_DISRUPTIVE_ALLOWED_ACTION

Ganti kode berikut:

  • INSTANCE_GROUP_NAME: nama MIG.
  • INSTANCE_NAMES: daftar instance yang akan menerapkan template.
  • MINIMAL_ACTION (opsional): tindakan yang akan dilakukan pada setiap instance selama pembaruan konfigurasinya:
    • refresh (default): menerapkan konfigurasi baru pada instance yang berjalan tanpa memulai ulang.
    • restart: memulai ulang VM selama update, yang berguna jika aplikasi Anda hanya membaca metadata selama proses mulai ulang.
    • replace: menghapus VM dan membuat VM baru untuk menerapkan konfigurasi baru.
  • MOST_DISRUPTIVE_ALLOWED_ACTION (opsional): lakukan tindakan ini paling banyak pada setiap instance. Jika update konfigurasi memerlukan tindakan yang lebih mengganggu daripada yang ditentukan di sini, update akan gagal dan tidak akan ada perubahan yang dilakukan.
    • none: tidak ada tindakan
    • refresh: menerapkan konfigurasi baru tanpa menghentikan instance, jika memungkinkan. Misalnya, gunakan refresh untuk menerapkan perubahan yang hanya memengaruhi metadata atau disk tambahan.
    • restart: menerapkan konfigurasi baru tanpa mengganti instance, jika memungkinkan. Misalnya, menghentikan instance dan memulainya lagi sudah cukup untuk menerapkan perubahan pada jenis mesin.
    • replace: mengganti instance lama sesuai dengan flag --replacement-method.

REST

Anda dapat mengonfigurasi update selektif (oportunistik) dengan membuat permintaan PATCH pada MIG tingkat zona atau regional.

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

{
  "updatePolicy": {
    "type": "OPPORTUNISTIC"
  }
}

Jika Anda menetapkan jenis update grup ke OPPORTUNISTIC, Anda harus memulai update saat ingin menerapkan konfigurasi baru ke VM yang ada.

Menerapkan konfigurasi ke VM tertentu

Untuk memperbarui instance tertentu, gunakan permintaan berikut:

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

{
  "instances": [
    "zones/ZONE/instances/INSTANCE_NAME_1",
    "zones/ZONE/instances/INSTANCE_NAME_2"
  ],
  "minimalAction": MINIMAL_ACTION,
  "mostDisruptiveAllowedAction": MOST_DISRUPTIVE_ALLOWED_ACTION
}

Menerapkan konfigurasi ke semua VM

Untuk memperbarui semua instance yang ada, gunakan permintaan berikut:

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

{
  "allInstances": true,
  "minimalAction": MINIMAL_ACTION,
  "mostDisruptiveAllowedAction": MOST_DISRUPTIVE_ALLOWED_ACTION
}

Ganti kode berikut:

  • PROJECT_ID: project tempat MIG berada.
  • REGION: region tempat MIG Anda berada. Untuk MIG tingkat zona, ganti regions/REGION dengan zones/ZONE.
  • INSTANCE_GROUP_NAME: nama MIG.
  • MINIMAL_ACTION (opsional): tindakan yang akan dilakukan pada setiap instance selama pembaruan konfigurasi:
    • REFRESH: menerapkan konfigurasi baru pada instance yang sedang berjalan tanpa memulai ulang.
    • RESTART: memulai ulang VM selama update, yang berguna jika aplikasi Anda hanya membaca metadata selama proses mulai ulang.
    • REPLACE: menghapus VM dan membuat VM baru untuk menerapkan konfigurasi baru.
  • MOST_DISRUPTIVE_ALLOWED_ACTION (opsional): lakukan tindakan ini paling banyak pada setiap instance. Jika update konfigurasi memerlukan tindakan yang lebih mengganggu daripada yang ditentukan di sini, update akan gagal dan tidak akan ada perubahan yang dilakukan.
    • NONE: tidak ada tindakan
    • REFRESH: menerapkan konfigurasi baru tanpa menghentikan instance, jika memungkinkan. Misalnya, gunakan REFRESH untuk menerapkan perubahan yang hanya memengaruhi metadata atau disk tambahan.
    • RESTART: menerapkan konfigurasi baru tanpa mengganti instance, jika memungkinkan. Misalnya, menghentikan instance dan memulainya lagi sudah cukup untuk menerapkan perubahan pada jenis mesin.
    • REPLACE: mengganti instance lama sesuai dengan kolom updatePolicy.replacementMethod grup.

Memastikan apakah konfigurasi semua instance yang diperbarui telah diterapkan

Anda dapat memverifikasi apakah konfigurasi semua instance terbaru telah diterapkan ke semua VM dalam grup dengan menggunakan salah satu cara berikut.

Konsol

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

    Buka Instance groups

  2. Pilih MIG yang konfigurasi semua instance-nya ingin Anda lihat.

  3. Buka tab Detail.

  4. Jika konfigurasi semua instance terbaru diterapkan ke semua VM, maka di bagian Konfigurasi semua instance, stempel waktu Terakhir diubah dan kolom Status harus menampilkan nilai sebagai berikut:

    • Terakhir diubah: Menampilkan waktu saat Anda menerapkan konfigurasi semua instance ke semua VM.
    • Status: Menampilkan Diterapkan ke semua VM. Jika semua instance tidak diterapkan ke semua VM, statusnya akan ditampilkan sebagai Update VM tertunda.

gcloud

Gunakan perintah describe dan sertakan flag --format untuk mencari nilai status.allInstancesConfig.effective.

gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --format="(status.allInstancesConfig)"

Contoh output:

status:
  allInstancesConfig:
    currentRevision: 2022-12-02T10:30:15.012345Z
    effective: true

Jika nilai effective ditetapkan ke true, berarti semua VM telah menerapkan konfigurasi terbaru. Nilai currentRevision menunjukkan stempel waktu perubahan terbaru pada konfigurasi semua instance grup.

Jika nilai effective ditetapkan ke false, berarti konfigurasi terbaru belum diterapkan ke semua VM.

Untuk memeriksa status setiap VM, Anda dapat membuat daftar semua VM MIG atau memeriksa setiap VM satu per satu dengan perintah describe-instance:

gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME

Contoh output:

allInstancesConfig:
  revision: 2022-12-02T10:30:15.012345Z
currentAction: NONE
id: '8393021473297481188'
instance: .../projects/PROJECT/zones/ZONE/instances/INSTANCE_NAME
instanceStatus: RUNNING
name: INSTANCE_NAME
version:
  instanceTemplate: .../projects/PROJECT/global/instanceTemplates/INSTANCE_TEMPLATE

Untuk melihat VM mana yang menerapkan konfigurasi terbaru, bandingkan stempel waktu revision pada setiap VM dengan stempel waktu currentRevision pada MIG.

REST

Buat permintaan GET pada MIG tingkat zona atau regional untuk memeriksa nilai flag status.allInstancesConfig.effective.

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

Contoh respons:

{
  ...
  "status": {
    "isStable": "true",
    "versionTarget": {
      "isReached": "true"
    },
    "allInstancesConfig": {
      "currentRevision": "2022-12-02T10:30:15.012345Z",
      "effective": "true"
    },
  ...
  },
  ...
}

Jika kolom effective ditetapkan ke true, berarti semua VM telah menerapkan konfigurasi terbaru. Kolom currentRevision menampilkan stempel waktu perubahan terbaru pada konfigurasi semua instance grup.

Jika kolom effective ditetapkan ke false, berarti konfigurasi terbaru belum diterapkan ke semua VM.

Untuk memeriksa status setiap instance, buat daftar instance terkelola untuk MIG tingkat zona atau regional:

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

Contoh output:

{
  "managedInstances": [
    ...
    {
      "instance": ".../zones/ZONE/instances/INSTANCE_NAME",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "allInstancesConfig": {
        "revision": "2022-12-02T10:30:15.012345Z"
      },
      "version": {
        "name": "V1",
        "instanceTemplate": ".../projects/.../instanceTemplates/INSTANCE_TEMPLATE"
      }
    },
    {
      ...
    }
  ]
}

Untuk melihat VM mana yang menerapkan konfigurasi terbaru, bandingkan stempel waktu revision pada setiap VM dengan stempel waktu currentRevision pada MIG.

Mencantumkan properti dalam konfigurasi semua instance

Konfigurasi semua instance adalah bagian dari konfigurasi MIG. Untuk meninjau konfigurasi semua instance, gunakan salah satu cara berikut.

Konsol

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

    Buka Instance groups

  2. Pilih MIG yang konfigurasi semua instance-nya ingin Anda lihat.

  3. Buka tab Detail.

  4. Lihat bagian Konfigurasi semua instance.

gcloud

Gunakan perintah describe dan sertakan flag --format untuk menampilkan nilai konfigurasi semua instance grup.

gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --format="(allInstancesConfig)"

Perintah ini akan menampilkan konfigurasi semua instance grup, jika ada.

REST

Buat permintaan GET pada MIG tingkat zona atau regional, lalu cari kolom allInstancesConfig.

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

Jika kolom allInstancesConfig tidak ditetapkan, grup tidak akan memiliki konfigurasi semua instance.

Menghapus properti dari konfigurasi semua instance

Jika Anda menghapus suatu properti dari konfigurasi semua instance MIG, dan properti yang sama ada di template instance MIG, VM di MIG akan mewarisi kembali properti tersebut dari template instance setelah konfigurasi terbaru diterapkan ke VM di MIG. Untuk mengetahui informasi selengkapnya tentang cara menerapkan konfigurasi terbaru ke VM yang ada, lihat Menerapkan konfigurasi semua instance ke VM yang ada.

Untuk menghapus properti dari konfigurasi semua instance, gunakan salah satu cara berikut.

Konsol

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

    Buka Instance groups

  2. Pilih MIG tempat Anda ingin menghapus konfigurasi semua instance.

  3. Klik Update VMs.

  4. Di bagian All-instances configuration, lakukan hal berikut:

    • Untuk menghapus metadata, klik Kelola metadata
    • Untuk menghapus label, klik Kelola label.
  5. Di panel Manage metadata atau Manage labels, lakukan hal berikut:

    1. Tahan kursor di setelan untuk mengaktifkan opsi hapus, lalu klik Hapus item.
    2. Klik Simpan.
  6. Setelah selesai menghapus, klik Update VMs.

    Jika jenis update MIG ditetapkan ke Otomatis, perubahan pada konfigurasi semua instance akan langsung diterapkan ke semua VM yang ada. Jika jenis updatenya adalah Selektif, Anda harus menerapkan konfigurasi secara selektif ke VM yang ada. Untuk mengetahui informasi selengkapnya, lihat Menerapkan konfigurasi semua instance ke VM yang ada.

gcloud

Untuk menghapus properti, gunakan perintah all-instances-configuration delete dan tentukan satu atau beberapa kunci untuk properti yang ingin dihapus.

gcloud compute instance-groups managed all-instances-config delete INSTANCE_GROUP_NAME \
    --metadata=KEY1[, KEY1]\
    --labels=KEY1[, KEY1]

Jangan lupa menerapkan konfigurasi terbaru ke VM yang ada di MIG.

REST

Untuk menghapus properti, buat permintaan PATCH pada MIG tingkat zona atau regional dan tentukan nilai null sebagai kunci untuk setiap properti yang ingin Anda hapus.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME
{
  "allInstancesConfig": {
    "properties": {
      "metadata": {
        "KEY1": null,
        ...
      },
      "labels": {
        "KEY2": null,
        ...
      }
    }
  }
}

Jangan lupa menerapkan konfigurasi terbaru ke VM yang ada di MIG.

Langkah berikutnya