Memulai peristiwa pemeliharaan host secara manual

Halaman ini menjelaskan cara memulai peristiwa pemeliharaan host secara manual di instance Compute Engine yang didukung. Fitur ini memungkinkan Anda memulai peristiwa pemeliharaan untuk mengontrol waktu pemeliharaan instance Anda. Hal ini berguna untuk workload yang mungkin terpengaruh oleh penurunan performa atau periode nonaktif, yang memerlukan waktu mulai masa pemeliharaan pada waktu tertentu.

Saat Anda memulai peristiwa pemeliharaan secara manual, pemeliharaan host akan dimulai segera. Anda tidak dapat menentukan tanggal atau waktu mulai acara pemeliharaan. Jika Anda tidak menggunakan fitur ini, peristiwa pemeliharaan akan terjadi pada waktu yang ditunjukkan dalam notifikasi pemeliharaan mendatang.

Jika ingin menguji terlebih dahulu cara aplikasi Anda menangani peristiwa pemeliharaan, Anda dapat menyimulasikan peristiwa pemeliharaan.

Batasan

Anda dapat memulai peristiwa pemeliharaan host secara manual untuk instance yang menggunakan jenis mesin berikut:

Sebelum memulai

  • Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan dan API Google Cloud . Untuk menjalankan kode atau contoh 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:

    gcloud

    1. Instal Google Cloud CLI. Setelah penginstalan, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    2. Set a default region and zone.

    REST

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

      Instal Google Cloud CLI. Setelah penginstalan, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Peran yang diperlukan

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

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

Izin yang diperlukan

Izin berikut diperlukan untuk mengelola pemeliharaan VM:

  • Untuk mendapatkan informasi tentang instance komputasi: compute.instances.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Memulai peristiwa pemeliharaan host secara manual

Compute Engine mengirimkan notifikasi untuk peristiwa pemeliharaan mendatang dengan beberapa metode. Dengan menggunakan informasi dalam notifikasi, Anda dapat menentukan jangka waktu kapan Anda dapat memulai peristiwa pemeliharaan secara manual.

Periksa informasi notifikasi

Anda dapat menemukan notifikasi peristiwa pemeliharaan dengan salah satu cara berikut:

Jika notifikasi tentang peristiwa pemeliharaan host berisi canReschedule=True dan maintenanceStatus=Pending, Anda memiliki opsi untuk memulai pemeliharaan pada waktu yang Anda pilih, atau menunggu peristiwa pemeliharaan berlangsung pada waktu yang ditentukan oleh windowStartTime.

Jika tidak ada notifikasi, dan Anda mencoba memulai peristiwa pemeliharaan secara manual, pesan berikut akan ditampilkan:

There is no reschedulable upcoming maintenance.

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

Mulai peristiwa pemeliharaan

Anda dapat memulai pemeliharaan host pada waktu yang Anda pilih, bukan menunggu waktu yang dijadwalkan. Gunakan Google Cloud CLI atau REST untuk memicu peristiwa pemeliharaan, yang kemudian akan segera dimulai.

gcloud

Untuk memulai acara pemeliharaan, gunakan perintah compute instances perform-maintenance. Pemeliharaan host dimulai segera setelah memasukkan perintah.

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

Ganti kode berikut:

  • INSTANCE_NAME: Nama instance compute.
  • ZONE: Zona tempat instance berada.

Responsnya mirip dengan hal berikut ini:

resourceStatus:
  upcomingMaintenance:
    canReschedule: false
    latestWindowStartTime: '2025-01-15T19:57:17Z'
    maintenanceStatus: ONGOING
    type: SCHEDULED
    windowEndTime: '2025-01-15T23:57:11Z'
    windowStartTime: '2025-01-15T19:57:16Z'

Dalam respons, canReschedule disetel ke false dan maintenanceStatus disetel ke ONGOING, yang menunjukkan bahwa operasi pemeliharaan host sedang berlangsung.

REST

Untuk memulai peristiwa pemeliharaan, buat permintaan POST menggunakan metode instances.performMaintenance.

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

Ganti kode berikut:

  • PROJECT_NAME: Nama project
  • ZONE: Zona tempat instance komputasi berada
  • INSTANCE_NAME: nama instance

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, canReschedule disetel ke false dan maintenanceStatus disetel ke ONGOING, yang menunjukkan bahwa operasi pemeliharaan host sedang berlangsung.

Langkah berikutnya