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 yang digunakan untuk memverifikasi identitas Anda untuk mengakses Trusted Cloud by S3NS 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init
    2. Set a default region and zone.

    REST

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

      Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted 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 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 melakukan hal berikut:

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

Menetapkan ukuran MIG 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. Untuk mengetahui informasi selengkapnya, lihat Mengubah ukuran MIG secara manual.

Menggunakan permintaan pengubahan ukuran untuk membuat VM sekaligus

Anda dapat menggunakan permintaan pengubahan ukuran untuk menambahkan VM GPU ke MIG sekaligus. Fitur ini membantu Anda menghindari biaya untuk kapasitas sebagian saat Compute Engine menyediakan semua resource. Permintaan perubahan ukuran MIG menggunakan model penyediaan yang terikat dengan pemesanan atau flex-start. Model ini memungkinkan Anda mendapatkan vCPU dan GPU dengan harga diskon. Untuk mengetahui informasi selengkapnya, lihat Tentang permintaan pengubahan ukuran di MIG.

Menggunakan penskalaan otomatis untuk aplikasi stateless

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 workload atau sistem orkestrasi Anda memerlukan nama instance tertentu, Anda dapat menambahkan instance dengan nama tersebut ke MIG yang ada. Nama yang Anda tetapkan ke instance ini akan tetap ada jika MIG membuatnya ulang.

Berdasarkan cara Anda ingin menambahkan instance dengan nama tertentu ke MIG, gunakan salah satu metode berikut:

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

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