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. Hal ini berguna untuk workload yang mungkin terpengaruh oleh penurunan performa atau waktu nonaktif, yang memerlukan masa pemeliharaan untuk dimulai pada waktu tertentu.

Saat Anda memulai peristiwa pemeliharaan secara manual, pemeliharaan host akan segera dimulai. Anda tidak dapat menentukan tanggal atau waktu untuk memulai peristiwa 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 Google Cloud layanan dan API. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    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 .

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

      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 diperlukan 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, perluas 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 untuk memulai peristiwa pemeliharaan secara manual.

Memeriksa 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 terjadi 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 diambil.

Memulai 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 peristiwa pemeliharaan, gunakan perintah compute instances perform-maintenance. Pemeliharaan host akan segera dimulai setelah memasukkan perintah.

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

Ganti kode berikut:

  • INSTANCE_NAME: Nama instance komputasi.
  • 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 ditetapkan ke false dan maintenanceStatus ditetapkan 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 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 ditetapkan ke false dan maintenanceStatus ditetapkan ke ONGOING, yang menunjukkan bahwa operasi pemeliharaan host sedang berlangsung.

Langkah berikutnya