Mengelola kebijakan tamu (lama)

Setelah membuat kebijakan tamu, Anda dapat menggunakan prosedur berikut untuk meninjau dan mengelola kebijakan Anda:

• Perbarui kebijakan tamu: ubah konfigurasi kebijakan tamu Anda.
• Menjelaskan kebijakan tamu: mendapatkan detail tentang kebijakan tamu tertentu.
• Menampilkan daftar kebijakan tamu: melihat daftar kebijakan tamu dalam project.
• Menghapus tamu: menghapus kebijakan tamu tertentu.
• Melihat konfigurasi untuk instance VM: melihat konfigurasi yang diterapkan pada instance VM.
• Men-debug kebijakan tamu: memecahkan masalah kebijakan tamu.

Karena agen OS Config berjalan setiap 10-15 menit, saat Anda menyiapkan pembaruan atau penghapusan kebijakan, diperlukan waktu sekitar 10-15 menit untuk diterapkan.

Anda dapat mengelola kebijakan tamu menggunakan Google Cloud CLI atau REST.

Sebelum memulai

• Tinjau kuota OS Config.
• Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Trusted Cloud by S3NS 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:

  gcloud

  1. Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

     gcloud init

  2. Set a default region and zone.

  REST

  Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.

  Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

  gcloud init

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

Memperbarui kebijakan tamu

Untuk memperbarui kebijakan tamu, selesaikan langkah-langkah berikut:

1. Perbarui file YAML atau JSON.
2. Jalankan perintah update atau patch. Proses update mirip dengan proses pembuatan dengan penambahan dukungan untuk etag yang memungkinkan kontrol konkurensi dan konsistensi.

gcloud beta compute os-config guest-policies update POLICY_ID \
     --file=FILE

PATCH https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

{
  For more information, see Guest policy JSON
}

Mendeskripsikan kebijakan tamu

gcloud beta compute os-config guest-policies describe POLICY_ID

GET https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

Mencantumkan kebijakan tamu

gcloud beta compute os-config guest-policies list

GET https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies

Menghapus kebijakan tamu

Saat agen OS Config mendeteksi bahwa penghapusan kebijakan tamu dipicu, status sistem saat ini dipertahankan, tetapi tidak ada pemeliharaan konfigurasi lebih lanjut. Misalnya, Anda telah menyiapkan kebijakan tamu package-update-zone2b yang menginstal paket my-package pada semua VM di zona us-west2-b dan menyimpan paket UPDATED.

Jika Anda menghapus kebijakan package-update-zone2b, perubahan berikut akan terjadi:

• Semua VM di us-west2-b yang telah menginstal my-package akan tetap menginstal my-package. Tidak ada pembatalan status sistem saat ini.

• Pada semua pengoperasian agen OS Config di masa mendatang, hal berikut akan terjadi setelah penghapusan kebijakan:

  • Jika VM baru ditambahkan ke us-west2-b,my-package belum diinstal di VM baru ini.
  • Untuk instance dengan my-package terinstal, paket tidak diupdate.

gcloud beta compute os-config guest-policies delete POLICY_ID

DELETE https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

Melihat konfigurasi untuk instance VM

gcloud beta compute os-config guest-policies lookup VM_NAME \
    --zone=ZONE

POST https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME:lookupEffectiveGuestPolicy

Pemecahan masalah

Memeriksa kebijakan tamu

Anda dapat menggunakan konsol Trusted Cloud atau Google Cloud CLI untuk memeriksa kebijakan tamu yang terkait dengan project Anda.

Memeriksa kebijakan tamu untuk VM tertentu

Anda dapat menjalankan perintah lookup untuk VM tertentu guna mengetahui konfigurasi yang berlaku untuk VM tersebut.

Jika VM tampaknya tidak menerapkan persyaratan kebijakan tamu yang diharapkan, sebaiknya periksa daftar kebijakan tamu yang tugasnya mencakup instance VM tersebut. Hal ini membantu menentukan apakah kolom Assignment dalam kebijakan tamu cocok dengan VM tertentu ini.

Gunakan perintah os-config guest-policies lookup untuk mencantumkan kebijakan tamu yang mungkin menargetkan VM tertentu. Ganti VM_NAME dengan nama VM yang akan diperiksa.

gcloud beta compute os-config guest-policies lookup VM_NAME

Untuk mengetahui informasi selengkapnya, baca Melihat konfigurasi untuk instance VM.

Output dari perintah mungkin mengungkapkan bahwa VM sebenarnya tidak ditargetkan di properti penetapan VM dari kebijakan tamu. Misalnya, nama tersebut mungkin tidak tercantum dalam daftar Labels atau daftar awalan nama VM.

Memulihkan dari kegagalan

Penginstalan urutan langkah software yang gagal tidak akan dicoba lagi. Hal ini karena sistem tidak mengetahui status tempat urutan langkah software mengalami kegagalan.

Saat men-debug urutan langkah software yang gagal, sebaiknya lakukan langkah-langkah berikut:

1. Mengganti nama urutan langkah software.
2. Menghapus dan membuat ulang kebijakan tamu menggunakan urutan langkah software yang sudah diganti namanya.

Untuk mengetahui langkah pemecahan masalah lainnya, baca Memecahkan Masalah VM Manager.

Apa langkah selanjutnya?

• Pelajari kebijakan tamu OS (lama) lebih lanjut.
• Menyiapkan kebijakan tamu.