Memicu peristiwa pemeliharaan host

Halaman ini menjelaskan cara memicu peristiwa pemeliharaan host pada instance kelompok VM tertentu. Dengan fitur ini, Anda dapat memulai peristiwa pemeliharaan secara manual untuk mengontrol waktu pemeliharaan VM. Hal ini berguna untuk beban kerja yang mungkin terpengaruh oleh masa pemeliharaan tertentu.

Anda dapat memicu peristiwa pemeliharaan secara manual agar segera dimulai. Peristiwa tidak dapat dipicu pada tanggal atau waktu tertentu. Jika Anda tidak menggunakan fitur ini, peristiwa pemeliharaan akan terjadi sesuai jadwal.

Batasan

Pemicuan peristiwa pemeliharaan host VM terbatas pada jenis mesin VM berikut:

• Seluruh mesin standar C3, ber-mem tinggi, dan CPU tinggi dengan 176 vCPU
• VM C3 dengan SSD lokal
• Seluruh mesin standar C3D, bermem tinggi, dan CPU tinggi dengan 360 vCPU
• VM C3D dengan SSD lokal
• Mesin bermemori tinggi Z3 dengan 176 vCPU
• Mesin yang dioptimalkan untuk memori M1, M2, M3 berikut:
  • m3-ultramem-128
  • m3-megamem-128
  • m2-ultramem-416
  • m2-megamem-416
  • m2-hypermem-416
  • m1-ultramem-160
  • m1-megamem-96

Sebelum memulai

• Memulai pemeliharaan VM secara manual hanya tersedia di VM C3, C3D, dan Z3. Jika Anda menggunakan VM dari kelompok mesin lainnya, baca dokumen Menetapkan kebijakan pemeliharaan host.
• 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:

  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

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk membuat VM dan mengelola pemeliharaan VM, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Peran bawaan ini berisi izin yang diperlukan untuk membuat VM dan mengelola pemeliharaan VM. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Anda mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.

Memicu peristiwa pemeliharaan host

Google mengirimkan notifikasi untuk pemeliharaan VM mendatang dengan beberapa metode. Anda dapat menemukan notifikasi dengan membuat kueri untuk VM, server metadata, atau Cloud Logging.

Setelah menerima notifikasi tentang peristiwa pemeliharaan host, Anda memiliki opsi untuk segera memicu pemeliharaan, atau menunggu peristiwa pemeliharaan berlangsung sesuai jadwal.

Memulai peristiwa pemeliharaan

Anda dapat segera memulai pemeliharaan VM, bukan menunggu waktu yang dijadwalkan. Gunakan metode Google Cloud CLI atau REST untuk segera memicu pemeliharaan VM.

Jika tidak ada notifikasi, dan Anda mencoba memicu peristiwa pemeliharaan, pesan berikut akan ditampilkan:

There is no reschedulable upcoming maintenance.

Hal ini menunjukkan bahwa tidak ada peristiwa pemeliharaan yang dijadwalkan dan tidak ada tindakan yang perlu dilakukan.

gcloud compute instances perform-maintenance VM_NAME \
--zone=ZONE

upcomingMaintenance:{
  "canReschedule":false
  "latestWindowStartTime": "2023-12-01T19:00:01Z"
  "maintenanceStatus":"ONGOING"
  "type":"SCHEDULED"
  "windowEndTime": "2023-12-01T22:00:00Z"
  "windowStartTime": "2023-12-01T19:00:00Z"
}

POST: https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME/performMaintenance

upcomingMaintenance:{
  "canReschedule":false
  "latestWindowStartTime": "2023-12-01T19:00:01Z"
  "maintenanceStatus":"ONGOING"
  "type":"SCHEDULED"
  "windowEndTime": "2023-12-01T22:00:00Z"
  "windowStartTime": "2023-12-01T19:00:00Z"
}

Definisi status pemeliharaan

Definisi status berikut menjelaskan respons terhadap kueri pemeliharaan VM. Solusi ini memberikan informasi terkait pemeliharaan VM. Google Cloud CLI, REST, dan server metadata menggunakan respons yang sama ini:

• windowStartTime: awal periode waktu saat pemeliharaan terjadi
• windowEndTime: akhir jangka waktu saat pemeliharaan terjadi
• latestWindowStartTime: waktu paling awal jendela dapat dipindahkan
• maintenanceType: jenis pemeliharaan yang akan dilakukan
  • TIDAK ADA: tidak ada pemeliharaan yang dijadwalkan untuk VM ini
  • DIJADWALKAN: pemeliharaan akan mendapatkan pemberitahuan 7 hari
  • TIDAK DIJADWALKAN: pemeliharaan menunjukkan update penting dengan pemberitahuan yang jauh lebih sedikit

• canReschedule: apakah pemeliharaan dapat dipicu selama periode notifikasi untuk VM ini
  • TRUE: pemeliharaan yang dipicu pelanggan dapat dilakukan selama periode notifikasi
  • FALSE: pemeliharaan yang dipicu pelanggan tidak dapat dilakukan pada VM ini. Hal ini sering terjadi selama periode saat VM menjalani pemeliharaan

• maintenanceStatus: status operasi pemeliharaan saat ini
  • SEDANG BERLANGSUNG: operasi pemeliharaan sedang berlangsung
  • TERTUNDA: operasi pemeliharaan dijadwalkan, tetapi belum dimulai

Perilaku status pemeliharaan

Selagi Anda mengelola jadwal pemeliharaan, periksa status canReschedule= dan maintenanceStatus= kombinasi respons ini menjelaskan perilaku fitur yang diharapkan dan menampilkan salah satu kombinasi status berikut:

• Jika canReschedule=Yes dan maintenanceStatus=Pending Anda dapat memicu pemeliharaan pada VM.
• Jika canReschedule=No dan maintenanceStatus=Ongoing, pemeliharaan sedang berlangsung.
• Jika canReschedule=No dan maintenanceStatus=Pending VM Anda tidak mendukung pemeliharaan yang dipicu secara manual.

Langkah selanjutnya

• Pelajari cara Menyimulasikan peristiwa pemeliharaan host.
• Pelajari cara Mendapatkan pemberitahuan migrasi langsung.
• Pelajari cara membuat pemberitahuan berbasis log di Cloud Logging.