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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
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.
Di Konsol Google Cloud, buka halaman Instance groups.
Pilih MIG yang konfigurasi semua instance-nya ingin Anda tetapkan.
Klik Update VMs.
Di bagian All-instances configuration, lakukan hal berikut:
- Untuk menambahkan atau memperbarui nilai metadata, klik Kelola metadata. Selesaikan penyiapan, lalu klik Simpan.
- Untuk menambahkan atau memperbarui label, klik Kelola label. Selesaikan penyiapan dan klik Simpan.
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.
INSTANCE_GROUP_NAME
: nama MIG.KEYS
danVALUES
: pasangan nilai kunci untuk label atau metadata. Jika kunci tidak ada, maka perintah update akan menambahkannya. Untuk kunci yang sudah ada, nilainya akan diperbarui.PROJECT_ID
: project tempat MIG berada.REGION
: region tempat MIG Anda berada. Untuk MIG tingkat zona, gantiregions/REGION
denganzones/ZONE
.INSTANCE_GROUP_NAME
: nama MIG.KEYS
danVALUES
: pasangan nilai kunci untuk label atau metadata. Jika kunci tidak ada, permintaan akan menambahkannya. Untuk kunci yang sudah ada, nilainya akan diperbarui.- 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.
INSTANCE_GROUP_NAME
: nama MIG.MAX_UNAVAILABLE
(opsional): jumlah maksimum instance yang tidak tersedia selama update. Misalnya, jika Anda menetapkan flagupdate-minimal-action
kerestart
, 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
PROJECT_ID
: project tempat MIG berada.REGION
: region tempat MIG Anda berada. Untuk MIG tingkat zona, gantiregions/REGION
denganzones/ZONE
.INSTANCE_GROUP_NAME
: nama MIG.MAX_UNAVAILABLE
(opsional): jumlah maksimum instance yang tidak tersedia selama update. Misalnya, jika Anda menetapkan flagupdate-minimal-action
keRESTART
, 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
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 tindakanrefresh
: menerapkan konfigurasi baru tanpa menghentikan instance, jika memungkinkan. Misalnya, gunakanrefresh
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
.
PROJECT_ID
: project tempat MIG berada.REGION
: region tempat MIG Anda berada. Untuk MIG tingkat zona, gantiregions/REGION
denganzones/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 tindakanREFRESH
: menerapkan konfigurasi baru tanpa menghentikan instance, jika memungkinkan. Misalnya, gunakanREFRESH
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 kolomupdatePolicy.replacementMethod
grup.
Di Konsol Google Cloud, buka halaman Instance groups.
Pilih MIG yang konfigurasi semua instance-nya ingin Anda lihat.
Buka tab Detail.
Jika konfigurasi semua instance terbaru diterapkan ke semua VM, 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.
Di Konsol Google Cloud, buka halaman Instance groups.
Pilih MIG yang konfigurasi semua instance-nya ingin Anda lihat.
Buka tab Detail.
Lihat bagian Konfigurasi semua instance.
Di Konsol Google Cloud, buka halaman Instance groups.
Pilih MIG tempat Anda ingin menghapus konfigurasi semua instance.
Klik Update VMs.
Di bagian All-instances configuration, lakukan hal berikut:
- Untuk menghapus metadata, klik Kelola metadata
- Untuk menghapus label, klik Kelola label.
Di panel Manage metadata atau Manage labels, lakukan hal berikut:
- Tahan kursor di setelan untuk mengaktifkan opsi hapus, lalu klik Hapus item.
- Klik Simpan.
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.
- Pelajari lebih lanjut tentang cara menerapkan secara otomatis konfigurasi terbaru ke VM yang ada di MIG.
- Pelajari lebih lanjut tentang cara menerapkan update konfigurasi secara selektif ke VM yang ada di MIG.
- Lihat informasi tentang MIG Anda dan VM-nya.
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
Menetapkan properti dalam konfigurasi semua instance
Membuat dan mengupdate konfigurasi semua instance MIG menggunakan gcloud CLI atau REST.
Konsol
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:
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:
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)
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:
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:
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:
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:
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
gcloud
Gunakan perintah
describe
dan sertakan flag--format
untuk mencari nilaistatus.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 ketrue
, berarti semua VM telah menerapkan konfigurasi terbaru. NilaicurrentRevision
menunjukkan stempel waktu perubahan terbaru pada konfigurasi semua instance grup.Jika nilai
effective
ditetapkan kefalse
, 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 waktucurrentRevision
pada MIG.REST
Buat permintaan
GET
pada MIG tingkat zona atau regional untuk memeriksa nilai flagstatus.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 ketrue
, berarti semua VM telah menerapkan konfigurasi terbaru. KolomcurrentRevision
menampilkan stempel waktu perubahan terbaru pada konfigurasi semua instance grup.Jika kolom
effective
ditetapkan kefalse
, 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 waktucurrentRevision
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
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 kolomallInstancesConfig
.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
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 nilainull
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
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-12-22 UTC.
-