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.
• 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

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  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.

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 siklus proses 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.

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

Catatan: Berbagai kebijakan dan tindakan akan membuat, menghapus, dan mengubah instance VM dalam MIG. Operasi tersebut ditampilkan sebagai DONE setelah grup menjadwalkan tindakan untuk membuat, menghapus, atau memperbarui instance tersebut. Namun, ini tidak berarti bahwa instance sebenarnya dalam grup telah dibuat, dihapus, atau diperbarui hingga tindakan yang mendasarinya tersebut selesai. Anda harus memverifikasi status grup atau memverifikasi status instance tersebut.

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:

• Menetapkan ukuran MIG secara manual.
• Menggunakan penskalaan otomatis untuk aplikasi stateless.
• Membuat instance dengan nama tertentu.

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:

• Mengubah ukuran MIG. MIG akan memilih instance yang akan dihapus.
  • Mengubah ukuran MIG secara manual.
  • Menggunakan penskalaan otomatis untuk aplikasi stateless.
• Menghapus seluruh grup.
• Menghapus atau mengabaikan instance tertentu secara eksplisit.

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 hingga 60 detik tambahan setelah durasi pengosongan koneksi telah berlalu sebelum instance VM dihapus.

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

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut:

• compute.instanceGroupManagers.update pada grup instance terkelola

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

• Pelajari cara menerapkan konfigurasi baru ke VM di MIG.
• Pelajari cara Menerapkan rekomendasi jenis mesin untuk MIG.
• Mencoba tutorial:
  • Menggunakan autohealing untuk aplikasi dengan ketersediaan tinggi
  • Menggunakan load balancing untuk aplikasi dengan ketersediaan tinggi
  • Menggunakan penskalaan otomatis untuk aplikasi yang sangat skalabel