Melihat penonaktifan halus di instance Compute Engine

Dokumen ini menjelaskan cara melihat setelan dan progres penghentian tuntas di instance Compute Engine. Untuk mempelajari penghentian tuntas lebih lanjut, lihat Ringkasan penghentian tuntas.

Saat melihat detail instance, Anda dapat melakukan hal berikut:

  • Melihat setelan penghentian tuntas. Anda dapat memverifikasi apakah penghentian tuntas diaktifkan dan durasinya.

  • Memantau penghentian tuntas. Saat penghentian tuntas sedang berlangsung, Anda dapat memeriksa hal berikut:

    • Saat proses penghentian tuntas mengalami error.

    • Jika operasi penghentian atau penghapusan sedang berlangsung.

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:

    Konsol

    Saat menggunakan Google Cloud konsol untuk mengakses Google Cloud layanan dan API, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI. Setelah penginstalan, 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 Anda perlukan untuk melihat penghentian tuntas 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 di project , yang diperlukan untuk melihat penghentian tuntas instance komputasi.

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

Melihat setelan penghentian tuntas

Untuk melihat setelan penghentian tuntas di instance komputasi, pilih salah satu opsi berikut:

Konsol

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

    Buka instance VM

  2. Di kolom Name, klik nama instance Anda.

    Halaman detail instance akan terbuka di tab Details.

  3. Untuk memeriksa setelan penghentian tuntas, di bagian Availability policies, periksa nilai kolom Graceful shutdown maximum duration. Kolom ini menampilkan periode penghentian tuntas. Jika menampilkan tanda hubung (-), penghentian tuntas akan dinonaktifkan.

gcloud

Untuk melihat setelan penghentian tuntas di instance, gunakan gcloud beta compute instances describe perintah:

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

Ganti kode berikut:

  • INSTANCE_NAME: nama instance.

  • ZONE: zona tempat instance berada.

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

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

Output ini mencakup nilai MAX_DURATION. Nilai ini menunjukkan durasi periode penghentian tuntas dalam detik. Jika Anda tidak menentukan periode penghentian khusus saat mengaktifkan penghentian tuntas di instance, Compute Engine akan menghapus kolom maxDuration dan menetapkan periode penghentian tuntas menjadi 10 menit.

REST

Untuk melihat setelan penghentian tuntas di instance, buat GET permintaan 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 tuntas diaktifkan, output-nya akan mirip dengan berikut ini:

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

Output ini mencakup nilai MAX_DURATION. Nilai ini menunjukkan durasi periode penghentian tuntas dalam detik. Jika Anda tidak menentukan periode penghentian khusus saat mengaktifkan penghentian tuntas di instance, Compute Engine akan menghapus kolom maxDuration dan menetapkan periode penghentian tuntas menjadi 10 menit.

Memantau penghentian tuntas

Untuk memantau penghentian tuntas yang sedang berlangsung di instance komputasi, pilih salah satu opsi berikut:

Konsol

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

    Buka instance VM

  2. Di kolom Name, klik nama instance Anda.

    Halaman detail instance akan terbuka di tab Details.

  3. Jika penghentian tuntas sedang berlangsung, di bagian Basic information , periksa kolom berikut:

    • Status: kolom ini menampilkan status instance Anda. Selama penghentian tuntas, kolom ini menampilkan Pending stop dan penghitung mundur. Penghitung mundur akan menghitung mundur hingga saat penghentian tuntas berakhir.

    • Target state: kolom ini menunjukkan apakah Compute Engine menghentikan (Stopped) atau menghapus (Deleted) instance.

gcloud

Untuk memantau penghentian tuntas 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 tuntas sedang berlangsung, output-nya akan mirip dengan berikut ini:

...
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 penghentian tuntas dalam detik. Setelah Compute Engine 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 penghentian tuntas. Instance akan tetap dalam status ini hingga Anda mengakhiri penghentian tuntas secara manual atau periode penghentian tuntas mengalami error.

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

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

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

REST

Untuk memantau penghentian tuntas yang sedang berlangsung di instance, buat GET permintaan 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 tuntas sedang berlangsung, output-nya akan mirip dengan berikut ini:

{
  ...
  "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 penghentian tuntas dalam detik. Setelah Compute Engine 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 penghentian tuntas. Instance akan tetap dalam status ini hingga Anda mengakhiri penghentian tuntas secara manual atau periode penghentian tuntas mengalami error.

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

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

Jika operasi penghentian sedang 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 tuntas sedang berlangsung, output-nya akan mirip dengan berikut ini:

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

    Output ini mencakup nilai-nilai berikut:

    • MAX_DURATION: durasi periode penghentian tuntas dalam detik. Setelah Compute Engine 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 penghentian tuntas. Instance akan tetap dalam status ini hingga Anda mengakhiri penghentian tuntas secara manual atau periode penghentian tuntas mengalami error.

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

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

Langkah berikutnya