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 beban kerja yang mungkin terpengaruh oleh performa menurun atau periode 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 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

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi 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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna 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 untuk memulai peristiwa pemeliharaan secara manual.

Memeriksa informasi notifikasi

Anda dapat menemukan notifikasi peristiwa pemeliharaan dengan:

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.

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

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

Langkah berikutnya