Melihat detail dan status ekstensi di VM

Gunakan metode list dan get status ekstensi hanya baca untuk melihat status runtime ekstensi yang diinstal di setiap instance VM tanpa terhubung ke setiap mesin. Saat Anda menggunakan kebijakan ekstensi, satu VM mungkin memiliki beberapa ekstensi yang diinstal oleh kebijakan yang berbeda. Metode status ekstensi memungkinkan Anda melihat konfigurasi efektif akhir dan kebijakan yang mengatur setiap ekstensi yang diinstal, serta membantu Anda memecahkan masalah saat ekstensi yang tidak terduga diinstal atau ekstensi gagal di instance.

Tentang detail ekstensi dan informasi status

Anda menginstal ekstensi VM di VM dengan membuat kebijakan ekstensi global atau zona di level organisasi, folder, atau project. Satu kebijakan dapat menginstal beberapa ekstensi di satu VM, dan beberapa kebijakan di seluruh hierarki resource Anda dapat diterapkan ke VM yang sama.

Metode status ekstensi hanya baca memungkinkan Anda mencantumkan status semua ekstensi di VM untuk melihat konfigurasi efektif akhir dan status runtime setiap ekstensi yang diinstal. Informasi yang ditampilkan menunjukkan versi aktif, status penegakan, status respons, dan ID kebijakan yang mengatur setiap ekstensi.

Melihat ekstensi dan versi VM

Anda dapat menggunakan Google Cloud CLI atau Compute Engine API untuk melihat detail tentang ekstensi VM yang diinstal. Dokumen ini menjelaskan cara menggunakan gcloud. Untuk mengetahui informasi tentang cara menggunakan Compute Engine API untuk melihat status ekstensi, lihat Melihat status ekstensi MV pada instance.

Izin IAM yang diperlukan untuk melihat detail ekstensi

Untuk melihat peran yang diperlukan untuk melihat informasi tentang ekstensi yang diinstal dan versinya dari level project, folder, atau organisasi, pilih salah satu level:

Project

Untuk mendapatkan izin yang diperlukan untuk melihat kebijakan ekstensi VM zonal atau global di level project, minta administrator untuk memberi Anda peran IAM Compute VM extension policy viewer (roles/compute.vmExtensionPolicyViewer) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat kebijakan ekstensi VM zonal atau global di level project. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat kebijakan ekstensi VM zonal atau global di level project:

  • Menjelaskan ekstensi VM tertentu pada instance: compute.vmExtensions.get
  • Mencantumkan semua ekstensi VM pada instance: compute.vmExtensions.list

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

Folder

Kebijakan ekstensi tingkat folder tersedia dalam Pratinjau.

Untuk mendapatkan izin yang diperlukan untuk melihat kebijakan ekstensi VM zona atau global di level folder, minta administrator untuk memberi Anda peran IAM Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) di folder Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat kebijakan ekstensi VM zonal atau global di level folder. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat kebijakan ekstensi VM zonal atau global di level folder:

  • Menjelaskan ekstensi VM tertentu pada instance: compute.folderVmExtensions.get
  • Mencantumkan semua ekstensi VM pada instance: compute.folderVmExtensions.list

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

Organisasi

Kebijakan ekstensi tingkat organisasi tersedia dalam Pratinjau.

Untuk mendapatkan izin yang diperlukan untuk melihat kebijakan ekstensi VM zonal atau global di level organisasi, minta administrator untuk memberi Anda peran IAM Organization level Compute VM extension policies viewer (roles/compute.orgVmExtensionPolicyViewer) di organisasi Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat kebijakan ekstensi VM zonal atau global di level organisasi. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat kebijakan ekstensi VM zonal atau global di tingkat organisasi:

  • Menjelaskan ekstensi VM tertentu pada instance: compute.orgVmExtensions.get
  • Mencantumkan semua ekstensi VM pada instance: compute.orgVmExtensions.list

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

Untuk mengetahui informasi selengkapnya tentang peran dan izin IAM di Compute Engine, lihat Peran dan izin Compute Engine.

Mencantumkan ekstensi dan versi VM

Untuk mencantumkan ekstensi dan versi VM yang dikelola oleh VM Extension Manager di seluruh zona atau secara global dalam project, folder, atau organisasi Anda, pilih salah satu opsi berikut:

Zonal

Gunakan perintah gcloud preview compute zone-vm-extension-policies extensions list untuk mencantumkan ekstensi VM di zona dalam project, folder, atau organisasi Anda:

Level project

gcloud preview compute zone-vm-extension-policies extensions list \
  --project=PROJECT_ID \
  --zone=ZONE

Ganti variabel berikut dalam perintah:

  • PROJECT_ID: ID project.
  • ZONE: Zona target; misalnya, us-central1-f.
Tingkat folder dan organisasi

Untuk melakukan tugas sebelumnya di level folder atau organisasi, gunakan perintah yang sama dengan salah satu perubahan berikut:

  • Untuk informasi tingkat folder, ganti opsi --project=PROJECT_ID dengan --folder=folders/FOLDER_ID, dengan FOLDER_ID adalah ID numerik folder Anda.
  • Untuk informasi tingkat organisasi, ganti opsi --project=PROJECT_ID dengan --organization=organizations/ORGANIZATION_ID, dengan ORGANIZATION_ID adalah ID numerik organisasi Anda.

Global

Gunakan perintah gcloud preview compute global-vm-extension-policies extensions list untuk mencantumkan ekstensi VM di semua zona dalam project, folder, atau organisasi Anda:

Level project

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

Ganti variabel berikut dalam perintah:

  • PROJECT_ID: ID project.
Tingkat folder dan organisasi

Untuk melakukan tugas sebelumnya di level folder atau organisasi, gunakan perintah yang sama dengan salah satu perubahan berikut:

  • Untuk informasi tingkat folder, ganti opsi --project=PROJECT_ID dengan --folder=folders/FOLDER_ID, dengan FOLDER_ID adalah ID numerik folder Anda.
  • Untuk informasi tingkat organisasi, ganti opsi --project=PROJECT_ID dengan --organization=organizations/ORGANIZATION_ID, dengan ORGANIZATION_ID adalah ID numerik organisasi Anda.

Melihat informasi tentang ekstensi VM tertentu

Untuk melihat detail ekstensi VM tertentu di satu zona atau secara global di project, folder, atau organisasi Anda, pilih salah satu opsi berikut:

Zonal

Gunakan perintah gcloud preview compute zone-vm-extension-policies extensions describe untuk melihat detail ekstensi VM tertentu di zona dalam project, folder, atau organisasi Anda:

Level project

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ganti variabel berikut dalam perintah:

  • EXTENSION_NAME: Salah satu ekstensi yang didukung VM Extension Manager; misalnya, ops-agent.
  • PROJECT_ID: ID project.
  • ZONE: Zona target; misalnya, us-central1-f.
Tingkat folder dan organisasi

Untuk melakukan tugas sebelumnya di level folder atau organisasi, gunakan perintah yang sama dengan salah satu perubahan berikut:

  • Untuk informasi tingkat folder, ganti opsi --project=PROJECT_ID dengan --folder=folders/FOLDER_ID, dengan FOLDER_ID adalah ID numerik folder Anda.
  • Untuk informasi tingkat organisasi, ganti opsi --project=PROJECT_ID dengan --organization=organizations/ORGANIZATION_ID, dengan ORGANIZATION_ID adalah ID numerik organisasi Anda.

Global

Gunakan perintah gcloud preview compute global-vm-extension-policies extensions describe untuk melihat detail ekstensi VM tertentu di semua zona dalam project, folder, atau organisasi Anda:

Level project

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

Ganti variabel berikut dalam perintah:

  • EXTENSION_NAME: Salah satu ekstensi yang didukung VM Extension Manager; misalnya, ops-agent.
  • PROJECT_ID: ID project.
Tingkat folder dan organisasi

Untuk melakukan tugas sebelumnya di level folder atau organisasi, gunakan perintah yang sama dengan salah satu perubahan berikut:

  • Untuk informasi tingkat folder, ganti opsi --project=PROJECT_ID dengan --folder=folders/FOLDER_ID, dengan FOLDER_ID adalah ID numerik folder Anda.
  • Untuk informasi tingkat organisasi, ganti opsi --project=PROJECT_ID dengan --organization=organizations/ORGANIZATION_ID, dengan ORGANIZATION_ID adalah ID numerik organisasi Anda.

Melihat status ekstensi VM pada instance

Kebijakan ekstensi dapat menginstal beberapa ekstensi di satu VM. Untuk menentukan status setiap ekstensi, termasuk konfigurasi efektif, status runtime, dan informasi lainnya, Anda dapat memeriksa status ekstensi pada VM tertentu.

Metode status ekstensi hanya menampilkan informasi tentang instance Agen Operasional yang diinstal dan dikelola oleh kebijakan VM Extension Manager. Jika beberapa VM menjalankan agen yang diinstal dengan cara lain, tidak ada informasi ekstensi yang dapat dilaporkan untuk agen tersebut.

Anda dapat menggunakan Google Cloud CLI atau Compute Engine API untuk melihat status ekstensi yang diinstal di VM. Dokumen ini menjelaskan cara menggunakan gcloud. Untuk mengetahui informasi tentang cara menggunakan Compute Engine API untuk melihat status ekstensi, lihat Melihat status ekstensi MV pada instance.

Izin IAM yang diperlukan untuk melihat status ekstensi

Untuk mendapatkan izin yang diperlukan untuk melihat status ekstensi VM pada instance, minta administrator untuk memberi Anda peran IAM Compute Viewer (roles/compute.viewer) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat status ekstensi VM pada instance. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat status ekstensi VM pada instance:

  • Mencantumkan status semua ekstensi VM pada instance: compute.instances.listVmExtensionStates
  • Mendapatkan status ekstensi VM tertentu pada instance: compute.instances.getVmExtensionState

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

Mencantumkan ekstensi yang diinstal pada instance VM

Untuk mencantumkan semua ekstensi VM yang diinstal pada instance dan melihat statusnya saat ini menggunakan gcloud, jalankan perintah gcloud beta compute instances list-vm-extension-states:

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Ganti variabel berikut dalam perintah:

  • INSTANCE_NAME: Nama instance VM.
  • PROJECT_ID: ID project.
  • ZONE: Zona tempat instance berada; misalnya, us-central1-f.

Perintah ini menampilkan nama, status penerapan, dan status respons setiap ekstensi yang diinstal. Untuk mengetahui informasi tentang nilai yang ditampilkan saat melihat status ekstensi, baca Menafsirkan kolom status ekstensi VM.

Untuk mengetahui informasi selengkapnya tentang cara melihat informasi tentang status ekstensi di VM Anda, termasuk informasi tentang penggunaan Compute Engine API, lihat Melihat status ekstensi MV di instance.

Melihat status ekstensi VM tertentu pada instance

Untuk mendapatkan informasi status tentang ekstensi VM tertentu yang diinstal pada VM menggunakan gcloud, jalankan perintah gcloud beta compute instances get-vm-extension-state:

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE \
    --extension-name=EXTENSION_NAME

Ganti variabel berikut dalam perintah:

  • INSTANCE_NAME: Nama instance VM.
  • PROJECT_ID: ID project.
  • ZONE: Zona tempat instance berada; misalnya, us-central1-f.
  • EXTENSION_NAME: Salah satu ekstensi yang didukung VM Extension Manager; misalnya, ops-agent.

Perintah ini menampilkan nama ekstensi, versi aktif, informasi kondisi, informasi penegakan, dan ID kebijakan yang mengatur. Untuk mengetahui informasi tentang nilai yang ditampilkan saat melihat status ekstensi, baca Menafsirkan kolom status ekstensi VM.

Untuk mengetahui informasi selengkapnya tentang cara melihat informasi tentang status ekstensi di VM Anda, termasuk informasi tentang penggunaan Compute Engine API, lihat Melihat status ekstensi MV di instance.

Langkah berikutnya