Bekerja dengan instance terkelola.

Grup instance terkelola (MIG) membuat setiap instance terkelola berdasarkan komponen konfigurasi yang Anda gunakan: template instance, konfigurasi semua instance opsional, dan konfigurasi stateful opsional.

Setiap instance terkelola adalah entity data yang mewakili status yang diinginkan untuk instance virtual machine (VM) sebenarnya dalam MIG.

Baca dokumen ini untuk mempelajari cara bekerja dengan instance terkelola di MIG secara andal. Misalnya, Anda mungkin perlu menambahkan, menghapus, memperbarui, atau melihat informasi tentang instance tertentu.

Untuk memastikan perubahan konfigurasi tidak dikembalikan oleh MIG, Anda harus menggunakan metode yang dijelaskan dalam dokumen ini. Jika Anda menggunakan selain metode grup untuk mengubah VM MIG, MIG bisa mendeteksi atau tidak bahwa VM tersebut tidak lagi menggunakan konfigurasi yang diinginkan grup, dan Anda mungkin mengalami hasil yang tidak terduga. Misalnya, jika Anda menghapus atau memperbarui VM di MIG dengan menggunakan API instance, bukan API pengelola grup instance yang diperlukan, MIG tidak akan mengetahui intent Anda dan dapat otomatis mencoba membuat ulang atau mengembalikan VM tersebut sesuai dengan konfigurasi MIG kapan saja di masa mendatang.

Sebelum memulai

  • Tinjau batasan lalu buat grup.
  • 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
    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

Apa yang dimaksud dengan instance terkelola?

Instance terkelola adalah entity data dalam MIG yang berisi status saat ini dan status yang diinginkan untuk instance VM yang sebenarnya.

Status instance terkelola saat ini mencakup kolom berikut:

  • Status lifecycle instance—misalnya, RUNNING, STOPPING.
  • Tindakan saat ini yang dilakukan oleh MIG pada instance—misalnya: RESTARTING, VERIFYING, NONE.
  • Status respons instance—misalnya, HEALTHY, UNHEALTHY.

Status instance terkelola yang dimaksud untuk instance VM aktual mencakup hal berikut:

  • Versi yang dimaksud, yaitu nama versi dan template instance yang akan digunakan untuk instance.
  • Status yang dipertahankan dari item (seperti disk atau metadata) yang akan dipertahankan.

Seperti yang ditunjukkan dalam gambar 1, untuk setiap instance terkelola dalam MIG, MIG menjaga VM yang sebenarnya tetap aktif dan berjalan sesuai dengan spesifikasi instance terkelola.

Berdasarkan konfigurasi Anda, MIG akan otomatis membuat instance terkelola, yang sesuai dengan instance VM sebenarnya yang dipelihara MIG untuk Anda.

Gambar 1. Hubungan antara instance terkelola dan VM yang sesuai.

Untuk melihat spesifikasi instance terkelola, lihat Melihat informasi tentang instance terkelola di MIG.

Menambahkan instance ke MIG

Untuk menambahkan lebih banyak instance ke MIG, Anda dapat:

Untuk memverifikasi bahwa instance yang baru ditambahkan sudah aktif dan berjalan, verifikasi status grup atau verifikasi status instance terkelola.

Mengubah ukuran secara manual

Jika grup instance terkelola belum ditetapkan untuk diskalakan secara otomatis, Anda dapat menetapkan ukuran grup secara manual untuk mengubah jumlah instance dalam grup. Lihat Mengubah ukuran MIG secara manual.

Penskalaan otomatis

Anda dapat mengonfigurasi grup instance terkelola untuk menambahkan atau menghapus instance secara otomatis berdasarkan workload-nya. Aplikasi Anda dapat menangani peningkatan traffic dengan baik, dan Anda dapat mengurangi biaya saat kebutuhan akan resource komputasi lebih rendah. Untuk mengetahui informasi selengkapnya tentang cara menskalakan MIG secara otomatis, lihat Penskalaan otomatis grup instance.

Menambahkan instance dengan nama tertentu

Jika memiliki sistem yang bergantung pada nama tertentu, Anda dapat menambahkan VM dengan nama tersebut ke MIG yang ada. Nama yang Anda tetapkan ke instance terkelola ini akan dipertahankan jika MIG membuat ulang VM. Untuk mengetahui informasi selengkapnya, lihat Membuat instance dengan nama tertentu di MIG

Untuk mengetahui informasi selengkapnya tentang cara mempertahankan status instance MIG, lihat MIG stateful.

Menghapus instance dari MIG

Saat Anda menghapus instance terkelola, MIG akan mengurangi targetSize grup dan menghapus instance VM yang terkait.

Jika Anda menyiapkan MIG stateful, MIG akan menghapus konfigurasi status instance yang dipertahankan. MIG juga akan menghapus instance dari semua kumpulan target di mana instance merupakan anggotanya.

Jika grup adalah bagian dari layanan backend yang telah mengaktifkan pengosongan koneksi, diperlukan waktu hingga 60 detik tambahan setelah durasi pengosongan koneksi berlalu sebelum instance VM dihapus.

Untuk menghapus instance terkelola, Anda dapat:

Memperbarui konfigurasi VM di MIG

Jika Anda perlu mengubah konfigurasi VM di MIG—misalnya, untuk mengubah boot disk atau jenis mesin, menambahkan disk, atau mengubah properti VM lainnya—lihat Memperbarui konfigurasi VM di MIG.

Membuat ulang instance di MIG

Gunakan metode ini untuk memperbarui VM yang dipilih agar menggunakan komponen konfigurasi VM terbaru grup. Jika Anda perlu membuat ulang semua VM dalam grup instance terkelola, mulai update berkelanjutan.

Jika grup adalah bagian dari layanan backend yang telah mengaktifkan pengosongan koneksi, diperlukan waktu tambahan hingga 60 detik setelah durasi pengosongan koneksi berlalu sebelum instance VM dihapus.

Buat ulang instance VM yang dipilih di grup instance terkelola menggunakan gcloud CLI, atau REST.

gcloud

Gunakan perintah instance-groups managed recreate-instances.

gcloud compute instance-groups managed recreate-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

REST

Di API, buat permintaan POST ke metode regionInstanceGroupManagers.recreateInstances. Untuk grup instance terkelola menurut zona, gunakan metode instanceGroupManagers.recreateInstances.

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

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ]
}

Setelah Anda membuat permintaan untuk membuat ulang instance VM dalam grup instance terkelola, VM baru akan dimulai segera setelah sistem dapat menyediakannya. Proses ini dapat memerlukan waktu lyang ama, bergantung pada jumlah instance yang Anda buat ulang. Verifikasi status grup atau verifikasi status instance terkelola.

Operasi pembuatan ulang akan mempertahankan nama instance VM, tetapi stempel waktu pembuatan instance mungkin tidak berubah. Untuk mengonfirmasi bahwa operasi pembuatan ulang telah membuat instance baru saat stempel waktu pembuatan instance tidak berubah, periksa stempel waktu pembuatan boot disk yang terpasang pada instance tersebut.

Melihat informasi tentang instance di MIG

Baca bagian Melihat info tentang instance terkelola di MIG.

Mengonfigurasi instance stateful di MIG

Lihat Mengonfigurasi MIG stateful.

Langkah berikutnya