Mengelola ekstensi VM menggunakan kebijakan ekstensi

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

VM Extension Manager menggunakan kebijakan ekstensi untuk mengelola ekstensi VM Anda dalam skala besar. Untuk mengetahui informasi selengkapnya, lihat artikel Tentang VM Extension Manager. Dokumen ini menjelaskan cara melihat, mengupdate, dan menghapus kebijakan ekstensi VM.

Peran dan izin IAM

Untuk mendapatkan izin yang diperlukan untuk melihat, mengubah, dan menghapus kebijakan ekstensi VM, minta administrator untuk memberi Anda peran IAM berikut pada project:

• Untuk melihat kebijakan ekstensi:
  • VM Extension Policy Viewer (roles/compute.vmExtensionPolicyViewer)
  • VM Extension Policy Admin (roles/compute.vmExtensionPolicyAdmin)
• Untuk mengubah kebijakan ekstensi: VM Extension Policy Admin (roles/compute.vmExtensionPolicyAdmin)
• Untuk menghapus kebijakan ekstensi: VM Extension Policy Admin (roles/compute.vmExtensionPolicyAdmin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat, mengubah, dan menghapus kebijakan ekstensi VM. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat, mengubah, dan menghapus kebijakan ekstensi VM:

• Untuk melihat kebijakan ekstensi: compute.vmExtensionPolicies.list
• Untuk melihat detail kebijakan ekstensi: compute.vmExtensionPolicies.get
• Untuk mengubah kebijakan ekstensi: compute.vmExtensionPolicies.update
• Untuk menghapus kebijakan ekstensi: compute.vmExtensionPolicies.delete

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.

Melihat kebijakan ekstensi

Anda dapat melihat daftar kebijakan ekstensi VM di project, atau melihat detail kebijakan tertentu menggunakan konsol Google Cloud atau Google Cloud CLI.

Konsol

1. Di konsol Google Cloud , buka halaman VM extension policies.

   Buka kebijakan ekstensi VM

   Halaman ini mencantumkan semua kebijakan ekstensi VM dalam project Anda.
2. Untuk melihat detail kebijakan ekstensi tertentu, klik nama kebijakan.

gcloud

Untuk melihat semua kebijakan ekstensi dalam project, gunakan perintah gcloud beta compute zone-vm-extension-policies list:

gcloud beta compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

Ganti kode berikut:

• PROJECT_ID: ID Google Cloud project Anda.
• ZONE: nama zona tempat Anda ingin mencantumkan kebijakan ekstensi VM.
• PAGE_SIZE: jumlah maksimum hasil yang akan ditampilkan per halaman.

Untuk melihat detail kebijakan ekstensi tertentu, gunakan perintah gcloud beta compute zone-vm-extension-policies describe:

gcloud beta compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda deskripsikan.
• PROJECT_ID: Google Cloud Project ID Anda.
• ZONE: Google Cloud zona tempat kebijakan ekstensi VM berada.

Mengubah ekstensi dengan memperbarui kebijakan ekstensi VM

Saat Anda mengupdate kebijakan, VM Extension Manager akan meluncurkan perubahan ke semua VM yang berlaku, biasanya dalam waktu satu menit. Jika Anda mengubah label penyertaan, ekstensi mungkin diinstal di VM baru atau di-uninstal dari VM yang ada berdasarkan apakah ekstensi tersebut cocok dengan label yang diperbarui.

Konsol

1. Di konsol Google Cloud , buka halaman VM extension policies.

   Buka kebijakan ekstensi VM

2. Pilih kebijakan yang ingin Anda perbarui.
3. Klik Edit.
4. Ubah Deskripsi, Prioritas, Ekstensi, atau Target VM instances.
5. Klik Simpan.

gcloud

Gunakan perintah gcloud beta compute zone-vm-extension-policies update untuk mengubah kebijakan ekstensi VM yang ada. Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan akan bertindak sebagai penggantian lengkap. Setiap kolom opsional yang Anda abaikan akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk memperbarui kebijakan ekstensi VM, jalankan perintah berikut:

  gcloud beta compute zone-vm-extension-policies update POLICY_NAME \
      --zone=ZONE \
      --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
      --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
      --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
      --inclusion-labels=KEY_1=VALUE_1 \
      --priority=PRIORITY_NUMBER \
      --description="DESCRIPTION"

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• ZONE: Google Cloud zona tempat kebijakan berlaku.
• EXTENSION_NAME_1, EXTENSION_NAME_2: nama ekstensi yang akan diperbarui. Anda harus menentukan setidaknya satu ekstensi.
• VERSION_1: versi ekstensi VM pertama.
• VERSION_2: versi ekstensi VM kedua.

• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: daftar pasangan nilai kunci yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah jalur ke file konfigurasi untuk ekstensi tersebut. Jalur ini ada di VM tempat Anda menjalankan perintah gcloud, bukan di VM tempat Anda menginstal ekstensi.

  Atau, untuk memberikan konfigurasi sebagai string inline, gunakan flag --config, bukan --config-from-file—misalnya, EXTENSION_NAME_1="CONFIG_1". Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.

• KEY_1=VALUE_1: daftar pasangan nilai kunci yang dipisahkan koma yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih agar dapat ditargetkan. Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan menargetkan VM yang cocok dengan salah satu pemilih yang diberikan (OR logis). Jika Anda menghapus tanda ini, kebijakan akan menargetkan semua VM di zona yang ditentukan.

• PRIORITY_NUMBER: nomor prioritas untuk kebijakan ekstensi VM.

• DESCRIPTION: deskripsi kebijakan ekstensi VM.

Meng-uninstal ekstensi dengan menghapus kebijakan ekstensi VM

Saat Anda menghapus kebijakan, VM Extension Manager akan meng-uninstal ekstensi dari VM yang dikelola oleh kebijakan tersebut. Namun, jika kebijakan aktif lain yang berprioritas lebih rendah diterapkan ke VM dan mendeklarasikan ekstensi yang sama, ekstensi akan tetap diinstal di VM tersebut berdasarkan kebijakan yang berprioritas lebih rendah.

VM Extension Manager menghapus ekstensi dari semua VM yang dapat diakses dalam waktu satu menit setelah penghapusan kebijakan. Jika VM tidak dapat diakses karena agen tamu dihapus atau VM dihapus, Pengelola Ekstensi VM akan melewati penghapusan ekstensi. Jika VM tersebut tersedia kembali, VM Extension Manager akan menghapus ekstensi pada saat itu.

Konsol

1. Di konsol Google Cloud , buka halaman VM extension policies.

   Buka kebijakan ekstensi VM

2. Pilih kebijakan yang ingin Anda hapus.
3. Klik Hapus.
4. Pada dialog konfirmasi, klik Delete.

gcloud

Gunakan perintah gcloud beta compute zone-vm-extension-policies delete untuk menghapus kebijakan ekstensi VM yang ada.

gcloud beta compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda hapus.
• PROJECT_ID: ID Google Cloud project Anda.
• ZONE: Google Cloud zona tempat kebijakan berada.

Memecahkan masalah ekstensi VM

Bagian ini menjelaskan cara memecahkan masalah ekstensi VM.

Memastikan ekstensi telah diinstal

Anda dapat memverifikasi bahwa ekstensi telah diinstal dengan memeriksa hal berikut di VM:

• Hubungkan ke VM dan periksa proses yang sedang berjalan.

  Tabel berikut mencantumkan nama proses untuk setiap ekstensi:

  Nama ekstensi	Nama proses ekstensi
  google-cloud-sap-extension	google_cloud_sap_agent
  google-cloud-workload-extension	google_cloud_workload_agent
  ops-agent	ops-agent

  Linux

  ps aux | grep 'EXTENSION_PROCESS_NAME'

  Ganti EXTENSION_PROCESS_NAME dengan nama proses ekstensi. Misalnya, untuk memeriksa proses Agen Operasional, jalankan perintah berikut:

  ps aux | grep 'ops-agent'

  Windows

  tasklist | findstr "EXTENSION_PROCESS_NAME"

  Ganti EXTENSION_PROCESS_NAME dengan nama proses ekstensi. Misalnya, untuk memeriksa proses Agen Operasional, jalankan perintah berikut:

  tasklist | findstr "ops-agent"

  Output perintah ps di VM Linux untuk Ops Agent mungkin menampilkan entri yang mirip dengan berikut ini:

  ....
  /var/lib/google-guest-agent/931374772276853249/plugins/ops-agent_baddabb3dac3
  ....

• Aktifkan dan tinjau log agen tamu. Log agen tamu menampilkan saat ekstensi diinstal dan dimulai.

  Berikut adalah contoh output yang mungkin Anda lihat di log agen tamu saat ekstensi Agen Operasional diinstal:

  my-instance google_guest_agent [14972]: Installing plugin "ops-agent", revision "2dfa648c1892da87"
  my-instance google_guest_agent [14972]: (client.go:181) Sent message [[type.googleapis.com/agent_controlplane.PluginEventMessage: (revision_id:"2dfa648c1892da87)]]
  my-instance google_guest_agent [14972]: (pluginengine.go:202) Running "DownloadPluginStep" on plugin "ops-agent_2dfa648c1892da87"
  my-instance google_guest_agent [14972]: (pluginengine.go:316) Successfully downloaded "https://storage.googleapis.com/acp-gcs-bucket-us-centrall-a/ops-agent
  my-instance google_guest_agent [14972]: (pluginengine.go:202) Running "UnpackPluginArchiveStep" on plugin "ops-agent_2dfa648c1892da87"
  my-instance google_guest_agent [14972]: (pluginengine.go:361) Successfully unpacked "/var/lib/google-guest-agent/ops-agent.tar.gz" to "/google-guest-agent/ops-agent_2dfa648c1892da87
  my-instance google_guest_agent [14972]: (pluginengine.go:202) Running "LaunchPluginStep" on plugin "ops-agent_2dfa648c1892da87"
  my-instance google_guest_agent [14972]: (run_linux.go:32) Attempting process start: (OutputType:0 Name:/var/lib/google-guest-agent/plugins/ops-agent_2dfa648c1892da87)
  my-instance google_guest_agent [14972]: (pluginlauncher.go:132) Launched a plugin process from "/var/lib/google-guest-agent/plugins/ops-agent_2dfa648c1892da87"
  my-instance google_guest_agent [14972]: (plugin.go:136) Dialing in on plugin "ops-agent 2dfa648c1892da87"
  my-instance google_guest_agent [14972]: (plugin.go:51) Executing start request on plugin "ops-agent_2dfa648c1892da87"

Memecahkan masalah penginstalan

Jika ekstensi tidak diinstal di VM setelah Anda membuat kebijakan, gunakan langkah-langkah berikut untuk memecahkan masalah:

1. Tunggu penerapan kebijakan. Diperlukan waktu hingga satu jam agar kebijakan diterapkan, termasuk percobaan ulang.
2. Periksa apakah label penyertaan yang ditentukan dalam kebijakan cocok dengan label di VM.
3. Untuk mengidentifikasi potensi error penginstalan, aktifkan logging debug untuk agen tamu.

4. Setelah Anda memperbaiki masalah yang mendasarinya, coba lagi penginstalan menggunakan salah satu metode berikut:

   • Buat ulang kebijakan: Hapus kebijakan, lalu buat kebijakan baru.

   • Gunakan kebijakan sementara dengan prioritas tinggi: Jika Anda ingin menghindari pembuatan ulang kebijakan yang memengaruhi banyak VM, gunakan kebijakan sementara dengan prioritas lebih tinggi untuk mencoba lagi penginstalan pada VM tertentu:

     1. Tambahkan label baru ke VM yang penginstalannya gagal. Misalnya, tambahkan label status=failed.
     2. Buat kebijakan dengan prioritas yang lebih tinggi yang menargetkan label baru. Misalnya, jika kebijakan asli yang gagal memiliki prioritas default 1000, buat kebijakan dengan prioritas yang lebih tinggi, seperti 500.

        gcloud beta compute zone-vm-extension-policies create temp-policy  
        
        --project=test-project 
        
        --zone=us-central1-f 
        
        --extensions=ops-agent 
        
        --config-from-file=ops-agent="/usr/ops-agent-config.yaml" 
        
        --priority=500 
        
        --inclusion-labels=status=failed

     3. Setelah ekstensi berhasil diinstal, hapus kebijakan sementara dan hapus label dari VM. Ekstensi tetap diinstal karena kebijakan asli masih aktif.

Melihat log debug untuk agen tamu

Untuk mengaktifkan logging debug, tambahkan setelan tingkat log dan kejelasan ke bagian Core file konfigurasi agen tamu sebagai berikut:

Linux

1. Buka file konfigurasi agen tamu yang berada di /etc/default/instance_configs.cfg.

2. Tambahkan baris berikut ke file. Jika bagian [Core] sudah ada, tambahkan setelan log_level dan log_verbosity ke bagian tersebut.

   [Core]
   log_level = 4
   log_verbosity = 4
   

3. Mulai ulang pengelola agen tamu dengan menjalankan perintah berikut:

    sudo systemctl restart google-guest-agent-manager
   

4. Untuk melihat log aktivitas agen tamu selama penginstalan ekstensi, jalankan perintah berikut:

   journalctl -u google-guest-agent-manager
   

Windows

1. Buka file konfigurasi agen tamu yang berada di C:\Program Files\Google\Compute Engine\instance_configs.cfg.

2. Tambahkan baris berikut ke file. Jika bagian [Core] sudah ada, tambahkan setelan log_level dan log_verbosity ke bagian tersebut.

   [Core]
   log_level = 4
   log_verbosity = 4
   

3. Mulai ulang pengelola agen tamu dengan menjalankan perintah berikut sebagai administrator Windows:

    net stop GCEAgentManager
    net start GCEAgentManager
   

4. Untuk melihat log aktivitas agen tamu selama penginstalan ekstensi, jalankan perintah berikut di PowerShell:

   Get-Eventlog -Source google_guest_agent_manager -LogName Application
   

Setelah mengaktifkan log debug, periksa error umum berikut:

• Ruang disk tidak cukup: Jika log melaporkan ruang disk tidak cukup, kosongkan ruang di disk atau ubah ukuran disk untuk menambahkan ruang.
• Penggunaan resource yang berlebihan: Jika log menunjukkan bahwa agen tamu menghentikan ekstensi karena penggunaan memori atau CPU yang berlebihan, ubah jenis mesin VM ke jenis mesin dengan resource yang lebih banyak.

Langkah berikutnya

• Pelajari VM Extension Manager lebih lanjut.