Melihat penonaktifan halus di instance Compute Engine

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

Saat melihat detail instance, Anda dapat melakukan hal berikut:

  • Lihat setelan penonaktifan yang benar. Anda dapat memverifikasi apakah penonaktifan yang benar diaktifkan dan berapa lama durasinya.

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

    • Saat proses penghentian tuntas kehabisan waktu.

    • Jika operasi berhenti atau hapus sedang berlangsung.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau sampel 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:

    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. After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      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.

          After installing the Google Cloud CLI, initialize it by running the following command: 

          gcloud init

          If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat penghentian yang benar pada 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 penonaktifan yang benar pada instance komputasi.

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

Melihat setelan penonaktifan yang benar

Untuk melihat setelan penonaktifan yang benar di instance komputasi, pilih salah satu opsi berikut:

Konsol

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

    Buka instance VM

  2. Di kolom Name, klik nama instance Anda.

    Halaman detail instance akan terbuka di tab Detail.

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

gcloud

Untuk melihat setelan penonaktifan yang benar 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 penonaktifan yang benar diaktifkan, output-nya akan mirip dengan berikut ini:

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

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

REST

Untuk melihat setelan penonaktifan yang benar 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 penonaktifan yang benar diaktifkan, output-nya akan mirip dengan berikut ini:

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

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

Memantau penghentian tuntas

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

Konsol

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

    Buka instance VM

  2. Di kolom Name, klik nama instance Anda.

    Halaman detail instance akan terbuka di tab Detail.

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

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

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

gcloud

Untuk memantau penonaktifan yang lancar 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 penonaktifan yang benar 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 yang benar 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 dapat berupa salah satu dari berikut:

    • PENDING_STOP: Compute Engine telah memulai penonaktifan yang benar. Instance akan tetap dalam status ini hingga Anda mengakhiri shutdown yang benar secara manual atau periode shutdown yang benar berakhir.

    • STOPPING: penonaktifan yang benar telah berakhir, dan Compute Engine melanjutkan operasi penghentian atau penghapusan.

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

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

REST

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

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 penonaktifan yang benar 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 yang benar 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 dapat berupa salah satu dari berikut:

    • PENDING_STOP: Compute Engine telah memulai penonaktifan yang benar. Instance akan tetap dalam status ini hingga Anda mengakhiri shutdown yang benar secara manual atau periode shutdown yang benar berakhir.

    • STOPPING: penonaktifan yang benar telah berakhir, dan Compute Engine melanjutkan operasi penghentian atau penghapusan.

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

Jika operasi penghentian sedang berjalan, setelah Compute Engine menyetel 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 penonaktifan yang benar 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 yang benar 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 penonaktifan yang benar. Instance tetap dalam status ini hingga Anda mengakhiri shutdown yang benar secara manual atau periode shutdown yang benar berakhir.

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

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

Langkah berikutnya