Melihat info tentang MIG dan instance terkelola

Gunakan metode di halaman ini untuk melihat informasi tentang grup instance terkelola (MIG) dan untuk melihat informasi tentang instance virtual machine (VM) dalam setiap MIG.

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

Lihat info tentang MIG

Anda dapat mengambil informasi tentang grup itu sendiri, misalnya, untuk memeriksa kebijakan yang melekat pada grup dan memeriksa apakah grup tersebut stabil atau mengalami perubahan. Untuk mendapatkan info tentang instance VM dalam MIG, baca Melihat info tentang instance terkelola.

Membuat daftar MIG

Untuk mendapatkan daftar grup instance terkelola, gunakan console, gcloud CLI, atau REST.

gcloud compute instance-groups managed list

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers

Melihat properti MIG

Untuk melihat informasi tentang MIG tertentu, termasuk kebijakannya (misalnya, kebijakan autohealing dan update grup), gunakan console, gcloud CLI, atau REST.

Untuk melihat nilai id grup, Anda harus menggunakan gcloud CLI atau Compute Engine API.

gcloud compute instance-groups managed describe instance-group \
    [--zone zone | --region region]

gcloud compute instance-groups managed describe instance-group --format="(autoscaler)"

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/regionAutoscalers/mig_name

Memeriksa apakah MIG stabil

Beberapa perintah dan permintaan membuat, menghapus, dan mengubah instance dalam grup instance terkelola. Operasi tersebut ditampilkan sebagai DONE setelah grup menjadwalkan tindakan untuk membuat, menghapus, atau memperbarui instance tersebut. Namun, ini tidak berarti bahwa instance dalam grup telah dibuat, dihapus, atau diupdate hingga tindakan yang mendasarinya tersebut selesai. Anda harus memverifikasi status grup, atau memverifikasi status instance tersebut.

Grup instance terkelola akan stabil ketika semua instance dalam grup instance terkelola tidak mengalami perubahan, tidak ada perubahan mendatang yang dijadwalkan untuk instance tersebut, dan grup itu sendiri tidak diubah.

Anda mungkin perlu mengetahui apakah grup stabil saat memiliki dependensi yang mengandalkan semua instance dalam grup yang responsif dan aktif. Misalnya, Anda mungkin ingin mulai menjadwalkan tugas, mengirim traffic, atau menetapkan rentang kunci setelah mendapatkan konfirmasi bahwa semua VM berjalan dan responsif.

Pastikan semua instance dalam grup instance terkelola berjalan dan responsif dengan memeriksa nilai kolom status.isStable grup.

gcloud compute instance-groups managed describe instance-group-name \
    [--zone zone | --region region]

gcloud compute instance-groups managed wait-until instance-group-name \
    --stable \
    [--zone zone | --region region]
Waiting for group to become stable, current operations: deleting: 4
Waiting for group to become stable, current operations: deleting: 4
...
Group is stable

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/get

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group-name/get

status.isStable yang ditetapkan ke false menunjukkan bahwa perubahan aktif, tertunda, atau MIG itu sendiri sedang diubah.

status.isStable yang ditetapkan ke true menunjukkan hal berikut:

• Tidak ada instance di MIG yang mengalami jenis perubahan apa pun dan currentAction untuk semua instance adalah NONE.
• Tidak ada perubahan yang tertunda untuk instance di MIG.
• MIG itu sendiri tidak dimodifikasi.

Ingatlah bahwa stabilitas MIG bergantung pada banyak faktor, karena MIG dapat dimodifikasi dengan berbagai cara. Contoh:

• Anda membuat permintaan untuk meluncurkan template instance baru.
• Anda membuat permintaan untuk membuat, menghapus, mengubah ukuran, atau memperbarui instance di MIG.
• Autoscaler meminta untuk mengubah ukuran MIG.
• Resource autohealer menggantikan satu atau beberapa instance yang tidak responsif di MIG.
• Pada MIG regional, beberapa instance sedang didistribusikan ulang.

Segera setelah semua tindakan selesai, status.isStable disetel ke true lagi untuk MIG tersebut.

Untuk setiap instance VM, baca bagian Memeriksa status instance terkelola.

Memeriksa apakah perbaikan VM dinonaktifkan di MIG

Untuk memeriksa apakah perbaikan VM dinonaktifkan di MIG, gunakan console, gcloud CLI, atau API.

gcloud compute instance-groups managed describe instance-group \
    --format="(instanceLifecyclePolicy)"

instanceLifecyclePolicy:
  defaultActionOnFailure: REPAIR
  forceUpdateOnRepair: NO

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP

"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "NO",
  "defaultActionOnFailure": "REPAIR"
}

Jika tidak ingin MIG memperbaiki VM yang gagal atau tidak sehat dalam grup, Anda dapat menonaktifkan perbaikan di MIG.

Lihat histori operasi autohealing

Jika telah mengonfigurasi autohealing, Anda dapat melihat peristiwa autohealing yang lalu.

Memantau update berkelanjutan

Jika Anda memulai update berkelanjutan, dan ingin mengetahui kapan update selesai, lihat Memantau update.

Lihat konfigurasi stateful

Jika Anda mengonfigurasi stateful MIG dan ingin meninjau konfigurasi, lihat Melihat konfigurasi stateful.

Melihat info tentang instance VM terkelola dalam MIG

Membuat daftar instance terkelola MIG

Untuk mendapatkan daftar instance terkelola dalam grup, termasuk status dan template-nya, gunakan console, gcloud CLI, atau REST.

gcloud compute instance-groups managed list-instances instance-group \
    [--zone zone | --region region]

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

Memeriksa status instance terkelola

Beberapa perintah dan permintaan membuat, menghapus, dan mengubah instance dalam grup instance terkelola. Operasi tersebut ditampilkan sebagai DONE setelah grup menjadwalkan tindakan untuk membuat, menghapus, atau memperbarui instance tersebut. Namun, ini tidak berarti bahwa instance dalam grup telah dibuat, dihapus, atau diupdate hingga tindakan yang mendasarinya tersebut selesai. Anda harus memverifikasi status instance tersebut, atau memverifikasi status grup itu sendiri.

Gunakan Google Cloud CLI atau REST untuk melihat detail tentang instance dalam grup instance terkelola. Detail mencakup status instance dan tindakan saat ini yang dilakukan grup pada instance-nya.

gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
    [--zone=ZONE | --region=REGION]

NAME               ZONE           STATUS   HEALTH_STATE  ACTION  INSTANCE_TEMPLATE  VERSION_NAME  LAST_ERROR
vm-instances-9pk4  us-central1-f                          CREATING  my-new-template
vm-instances-h2r1  us-central1-f  STOPPING                DELETING  my-old-template
vm-instances-j1h8  us-central1-f  RUNNING                 NONE      my-old-template
vm-instances-ngod  us-central1-f  RUNNING                 NONE      my-old-template

gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    [--zone=ZONE | --region=REGION]

currentAction: NONE
id: '6789072894767812345'
instance: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-mig-hz41
instanceStatus: RUNNING
name: example-mig-hz41
preservedStateFromConfig:
  metadata:
    example-key: example-value
preservedStateFromPolicy:
  disks:
    persistent-disk-0:
      autoDelete: NEVER
      mode: READ_WRITE
      source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-mig-hz41
version:
  instanceTemplate: https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

{
 "managedInstances": [
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-prvp",
   "id": "5317605642920955957",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-pz5j",
   "currentAction": "DELETING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-w2t5",
   "id": "2800161036826218547",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  }
 ]
}

Untuk melihat daftar nilai kolom instanceStatus yang valid, lihat Siklus proses instance VM.

Jika instance mengalami beberapa jenis perubahan, grup instance terkelola akan menetapkan kolom currentAction instance ke salah satu tindakan berikut untuk membantu Anda melacak progres perubahan tersebut. Jika tidak, kolom currentAction akan ditetapkan ke NONE.

Nilai currentAction yang mungkin adalah:

• ABANDONING. Instance sedang dihapus dari MIG.
• CREATING. Instance sedang dalam proses dibuat.
• CREATING_WITHOUT_RETRIES. Instance sedang dibuat tanpa percobaan ulang; jika instance tidak dibuat pada percobaan pertama, MIG tidak akan mencoba mengganti instance lagi.
• DELETING. Instance sedang dalam proses dihapus.
• RECREATING. Instance sedang diganti.
• REFRESHING. Instance dihapus dari kumpulan targetnya saat ini dan ditambahkan kembali ke daftar kumpulan target saat ini (daftar ini mungkin sama atau berbeda dari kumpulan target yang ada).
• RESTARTING. Instance sedang dalam proses dimulai ulang menggunakan metode stop dan start.
• RESUMING. Instance sedang dalam proses dilanjutkan setelah ditangguhkan.
• STARTING. Instance ini sedang dalam proses dimulai setelah dihentikan.
• STOPPING. Instance sedang dihentikan.
• SUSPENDING. Instance sedang ditangguhkan.
• VERIFYING. Instance telah dibuat dan sedang dalam proses diverifikasi.
• NONE. Tidak ada tindakan yang dilakukan pada instance.

Untuk memeriksa apakah grup secara keseluruhan stabil atau sedang mengalami perubahan, lihat Memeriksa status grup.

Memeriksa status respons

Jika telah mengonfigurasi autohealing untuk grup instance terkelola, Anda dapat meninjau status respons setiap VM. Lihat Memeriksa status respons.

Membuat daftar error instance

Jika instance terkelola mengalami error, Anda dapat melihat error tersebut untuk mendiagnosis dan mengurangi penyebabnya.

Gunakan Konsol Google Cloud, gcloud CLI, atau REST untuk menampilkan error.

gcloud compute instance-groups managed list-errors instance-group-name \
    [--zone zone | --region region]

gcloud compute instance-groups managed list-errors example-group \
    --region us-west1

INSTANCE_URL                                                                                        ACTION    ERROR_CODE      ERROR_MESSAGE                                                                                     TIMESTAMP                      INSTANCE_TEMPLATE                                                                                                            VERSION_NAME

https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-v0hl  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-v0hl' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.156-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-qp3d  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-qp3d' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.081-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
...

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/listErrors&maxResults=100

{
 "items": [
  {
   "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Instance 'example-mig-m1sz' creation failed: Quota 'CPUS' exceeded.  Limit: 50.0 in zone us-central1-c."
   },
   "timestamp": "2019-01-03T18:47:28.457-08:00",
   "instanceDetails" : {
    "instance": "zones/us-central1-c/instances/example-mig-m1sz",
    "action": "CREATING",
    "version": {
     "name": "example-version-name",
     "instanceTemplate": "global/instanceTemplates/example-template",
    }
   }
  }
 ],
 ...
 "nextPageToken": "Ch0yMDE5LTA3LTI5VDExOjA4OjA2LjYxMi0wNzowMBJ5aHR0cHM6Ly93d3cuZ29vZ2xlYXBpcy5jb20vY29tcHV0ZS9zdGFnaW5nX2FscGhhL3Byb2plY3RzL215cnpha2VyZXltcy1zdGFnaW5nL3pvbmVzL3VzLWNlbnRyYWwxLWlyMS9pbnN0YW5jZXMvaWdtLTEtcXAzZA=="
}

Daftar kemungkinan error mencakup, tetapi tidak terbatas pada, contoh berikut:

• Instance baru tidak dapat dibuat karena:
  • Tidak tersedianya kapasitas yang dapat dihentikan.
  • Kurangnya kuota, misalnya, untuk CPU di region tertentu.
  • Batas jumlah instance VM telah tercapai untuk jaringan yang terkait dengan grup ini.
  • Disk image yang ditentukan dalam kolom properties.disks[].initializeParams.sourceImage template instance telah dihapus, atau izinnya telah berubah.
  • Kartu kredit di akun penagihan yang terkait dengan project menolak pembayaran.
• Instance yang ada tidak dapat dihapus karena:
  • Akun layanan yang digunakan grup tidak memiliki izin compute.instances.delete.
  • Terlalu banyak penghapusan serentak yang diminta, hingga melebihi batas kapasitas.
• Instance tidak dapat ditambahkan ke kumpulan target karena kumpulan target telah dihapus.

Setelah memeriksa error tersebut, Anda dapat memitigasinya. Contoh:

• Pindahkan workload Anda ke zona lain yang memiliki kapasitas preemptible.
• Meminta penambahan kuota di region tertentu.
• Tambahkan izin compute.instances.delete ke akun layanan yang digunakan oleh grup.

Jika tindakan yang dipicu oleh grup instance terkelola gagal (misalnya, jika autoscaler mengalami error saat mencoba meningkatkan ukuran grup), grup tersebut mungkin akan segera mencoba kembali tindakan tersebut. Jika upaya percobaan ulang langsung terakhir gagal, MIG akan mencatat error, dan Anda dapat melihat error tersebut dengan mencantumkan error instance. Setelah beberapa waktu backoff, grup akan mencoba kembali tindakan yang gagal. Jika error masih berlanjut, kejadian mungkin direkam beberapa kali.

Compute Engine mempertahankan error 500 terbaru selama 8 hari terakhir meskipun instance yang mendasarinya tidak lagi ada atau tidak dapat dibuat.

Memeriksa apakah instance VM adalah bagian dari MIG

Anda dapat menggunakan konsol atau REST untuk memeriksa apakah VM tertentu merupakan anggota grup.

Atau, untuk mengidentifikasi apakah VM adalah anggota grup instance terkelola atau merupakan anggota dari grup instance terkelola, cari dua kunci metadata ini dalam metadata instance:

• instance-template menunjukkan template tempat VM dibuat.
• created-by menunjukkan grup instance terkelola yang membuat VM.

Meskipun Anda mengabaikan instance tersebut, VM akan tetap memiliki entri metadata ini, kecuali jika Anda menghapusnya secara manual.

Misalnya, jika terdapat VM bernama random-instance-biy dan Anda ingin mengetahui apakah VM tersebut dibuat oleh grup instance terkelola, Anda dapat menjelaskan instance dan mencari kunci metadata. Contoh:

gcloud compute instances describe random-instance-biy \
    --zone us-central1-f

gcloud CLI menampilkan respons yang mirip dengan:

canIpForward: false
cpuPlatform: Intel Ivy Bridge
creationTimestamp: '2016-08-24T14:11:38.012-07:00'
...
metadata:
  items:
  - key: instance-template
    value: projects/123456789012/global/instanceTemplates/example-it
  - key: created-by
    value: projects/123456789012/zones/us-central1-f/instanceGroupManagers/igm-metadata

Melihat status yang dipertahankan dari instance terkelola

Jika Anda mengonfigurasi stateful MIG dan ingin melihat status yang dipertahankan dari setiap instance terkelola, lihat Melihat konfigurasi stateful dan status yang dipertahankan.

Langkah selanjutnya

• Pelajari grup instance terkelola lebih lanjut.
• Buat template instance yang dapat Anda gunakan untuk membuat grup instance terkelola.