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:

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:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat VM dan mengelola pemeliharaan VM:

  • Untuk mendapatkan informasi tentang VM: compute.instances.get
  • Untuk membuat VM: compute.instances.create

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

Untuk segera memulai pemeliharaan, gunakan perintah gcloud compute instances perform-maintenance. Anda harus menyertakan --zone=[ZONE_NAME].

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

Ganti kode berikut:

  • VM_NAME: Nama VM.
  • ZONE: Zona tempat VM berada.

Responsnya akan terlihat seperti ini:

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"
}

Dalam respons, maintenanceStatus disetel ke ONGOING. Pemeliharaan sedang berlangsung.

REST

Untuk memicu pemeliharaan VM, jalankan perintah instances.performMaintenance:

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

Ganti kode berikut:

  • PROJECT_NAME: Nama project.
  • ZONE: Zona tempat VM berada.
  • VM_NAME: Nama VM.

Responsnya akan terlihat seperti ini:

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"
}

Dalam respons, maintenanceStatus disetel ke ONGOING. Pemeliharaan sedang berlangsung.

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