Melihat penonaktifan halus di instance Compute Engine

Dokumen ini menjelaskan cara melihat setelan dan progres penonaktifan secara halus di instance Compute Engine. Untuk mempelajari shutdown halus lebih lanjut, lihat Ringkasan shutdown halus.

Saat melihat detail instance, Anda dapat melakukan hal berikut:

  • Lihat setelan shutdown halus. Anda dapat memverifikasi apakah penonaktifan halus diaktifkan dan berapa lama durasinya.

  • Pantau penghentian normal. Saat penonaktifan yang baik sedang berlangsung, Anda dapat memeriksa hal berikut:

    • Saat waktu tunggu proses penghentian tuntas habis.

    • Jika operasi berhenti atau hapus sedang berlangsung.

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:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    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 agar dapat melihat penghentian yang wajar dari instance komputasi, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin compute.instances.get on the project, yang diperlukan untuk melihat penghentian halus instance komputasi.

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

Melihat setelan shutdown halus

Untuk melihat setelan shutdown halus di instance komputasi, pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud, buka halaman Instance VM.

    Buka instance VM

  2. Di kolom Nama, klik nama instance Anda.

    Halaman detail instance akan terbuka di tab Details.

  3. Untuk memeriksa setelan penonaktifan halus, di bagian Kebijakan ketersediaan, periksa nilai kolom Graceful shutdown maximum duration. Kolom ini menunjukkan periode penonaktifan yang wajar. Jika menampilkan tanda hubung (-), penonaktifan graceful shutdown akan diaktifkan.

gcloud

Untuk melihat setelan shutdown halus di instance, gunakan perintah gcloud beta compute instances describe:

gcloud beta compute instances describe INSTANCE_NAME \
    --zone=ZONE

Ganti kode berikut:

  • INSTANCE_NAME: nama instance.

  • ZONE: zona tempat instance berada.

Jika penghentian halus diaktifkan, output-nya akan mirip dengan berikut:

...
scheduling:
  ...
  gracefulShutdown:
    enabled: true
    maxDuration:
      seconds: 'MAX_DURATION'
  ...
...

Output-nya mencakup nilai MAX_DURATION. Nilai ini menunjukkan durasi periode shutdown halus dalam detik. Jika Anda tidak menentukan periode shutdown kustom saat mengaktifkan shutdown halus di instance, Compute Engine akan menghapus kolom maxDuration dan menetapkan periode shutdown halus ke 10 menit.

REST

Untuk melihat setelan penonaktifan yang baik di instance, buat permintaan GET ke metode instances.get beta:

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Ganti kode berikut:

  • PROJECT_ID: ID project tempat Anda membuat instance.

  • ZONE: zona tempat instance berada.

  • INSTANCE_NAME: nama instance.

Jika penghentian halus diaktifkan, output-nya akan mirip dengan berikut:

{
  ...
  "scheduling": {
    ...
    "gracefulShutdown": {
      "enabled": true,
      "maxDuration": {
        "seconds": "MAX_DURATION"
      }
    }
  },
  ...
}

Output-nya mencakup nilai MAX_DURATION. Nilai ini menunjukkan durasi periode shutdown halus dalam detik. Jika Anda tidak menentukan periode shutdown kustom saat mengaktifkan shutdown halus di instance, Compute Engine akan menghapus kolom maxDuration dan menetapkan periode shutdown halus ke 10 menit.

Memantau penghentian tuntas

Untuk memantau penonaktifan halus yang sedang berlangsung di instance komputasi, pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud, buka halaman Instance VM.

    Buka instance VM

  2. Di kolom Nama, klik nama instance Anda.

    Halaman detail instance akan terbuka di tab Details.

  3. Jika penonaktifan yang wajar sedang berlangsung, di bagian Informasi dasar, periksa kolom berikut:

    • Status: kolom ini menampilkan status instance Anda. Selama penghentian yang wajar, kolom ini menampilkan Pending stop dan penghitung mundur. Timer menghitung mundur hingga saat penonaktifan halus berakhir.

    • Status target: kolom ini menunjukkan apakah Compute Engine menghentikan (Dihentikan) atau menghapus (Dihapus) instance.

gcloud

Untuk memantau penghentian halus yang sedang berlangsung di instance, gunakan perintah gcloud beta compute instances describe:

gcloud beta compute instances describe INSTANCE_NAME \
    --zone=ZONE

Ganti kode berikut:

  • INSTANCE_NAME: nama instance.

  • ZONE: zona tempat instance berada.

Jika penghentian halus sedang berlangsung, outputnya akan mirip dengan berikut:

...
resourceStatus:
  ...
  shutdownDetails:
    maxDuration:
      seconds: 'MAX_DURATION'
    requestTimestamp: 'REQUEST_TIMESTAMP'
    stopState: STOP_STATE
    targetState: TARGET_STATE
...
status: PENDING_STOP
...

Output ini mencakup nilai-nilai berikut:

  • MAX_DURATION: durasi periode penonaktifan secara halus dalam detik. Setelah menetapkan STOP_STATE ke STOPPING, Compute Engine akan menghapus kolom maxDuration.

  • REQUEST_TIMESTAMP: stempel waktu saat STOP_STATE dimulai.

  • STOP_STATE: fase penghentian instance. Nilainya dapat berupa salah satu dari berikut ini:

    • PENDING_STOP: Compute Engine telah memulai penonaktifan secara halus. Instance akan tetap dalam status ini hingga Anda secara manual menghentikan shutdown halus atau periode shutdown halus habis waktunya.

    • STOPPING: penghentian halus telah berakhir, dan Compute Engine melanjutkan operasi berhenti atau hapus.

  • TARGET_STATE: apakah Compute Engine menghentikan (STOPPED) atau menghapus (DELETED) instance.

Jika operasi berhenti berjalan, setelah Compute Engine menetapkan kolom status ke TERMINATE, Compute Engine akan menghapus kolom shutdownDetails.

REST

Untuk memantau penonaktifan yang sedang berlangsung di instance, buat permintaan GET ke metode instances.get beta:

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Ganti kode berikut:

  • PROJECT_ID: ID project tempat Anda membuat instance.

  • ZONE: zona tempat instance berada.

  • INSTANCE_NAME: nama instance.

Jika penghentian halus sedang berlangsung, outputnya akan mirip dengan berikut:

{
  ...
  "resourceStatus": {
    ...
    "shutdownDetails": {
      "maxDuration": {
        "seconds": "MAX_DURATION"
      },
      "requestTimestamp": "REQUEST_TIMESTAMP",
      "stopState": "STOP_STATE",
      "targetState": "TARGET_STATE"
    }
  },
  ...
  "status": "PENDING_STOP",
  ...
}

Output ini mencakup nilai-nilai berikut:

  • MAX_DURATION: durasi periode penonaktifan secara halus dalam detik. Setelah menetapkan STOP_STATE ke STOPPING, Compute Engine akan menghapus kolom maxDuration.

  • REQUEST_TIMESTAMP: stempel waktu saat STOP_STATE dimulai.

  • STOP_STATE: fase penghentian instance. Nilainya dapat berupa salah satu dari berikut ini:

    • PENDING_STOP: Compute Engine telah memulai penonaktifan secara halus. Instance akan tetap dalam status ini hingga Anda secara manual menghentikan shutdown halus atau periode shutdown halus habis waktunya.

    • STOPPING: penghentian halus telah berakhir, dan Compute Engine melanjutkan operasi berhenti atau hapus.

  • TARGET_STATE: apakah Compute Engine menghentikan (STOPPED) atau menghapus (DELETED) instance.

Jika operasi berhenti berjalan, setelah Compute Engine menetapkan kolom status ke TERMINATE, Compute Engine akan menghapus kolom shutdownDetails.

Server metadata

  1. Hubungkan ke instance.

  2. Buat kueri server metadata:

    curl "http://metadata.google.internal/computeMetadata/v1/instance/shutdown-details/?recursive=true?alt=json" \-H "Metadata-Flavor: Google"

    Jika penghentian halus sedang berlangsung, outputnya akan mirip dengan berikut:

    {
  "maxDuration": "MAX_DURATION",
  "requestTimestamp": "REQUEST_TIMESTAMP",
  "stopState": "STOP_STATE",
  "targetState": "TARGET_STATE"
}

    Outputnya mencakup nilai berikut:

    • MAX_DURATION: durasi periode penonaktifan halus dalam hitungan detik. Setelah menetapkan STOP_STATE ke STOPPING, Compute Engine akan menghapus kolom maxDuration.

    • REQUEST_TIMESTAMP: stempel waktu saat STOP_STATE dimulai.

    • STOP_STATE: fase penghentian instance. Nilainya bisa berupa salah satu dari berikut:

      • PENDING_STOP: Compute Engine telah memulai penonaktifan yang wajar. Instance tetap dalam status ini hingga Anda mengakhiri shutdown halus secara manual atau periode shutdown halus habis waktunya.

      • STOPPING: shutdown halus telah berakhir, dan Compute Engine melanjutkan operasi penghentian atau penghapusan.

    • TARGET_STATE: apakah Compute Engine menghentikan (STOPPED) atau menghapus (DELETED) instance.

Langkah berikutnya