Mengelola penetapan kebijakan OS

Setelah Anda membuat penetapan kebijakan OS, tinjau dan kelola penetapan Anda menggunakan prosedur berikut:

• Update penetapan kebijakan OS: ubah konfigurasi untuk penetapan kebijakan OS Anda
• Jelaskan penetapan kebijakan OS: dapatkan detail tentang penetapan kebijakan OS tertentu
• Cantumkan penetapan kebijakan OS: lihat daftar penetapan kebijakan OS di zona tertentu
• Cantumkan revisi penetapan kebijakan OS: lihat daftar revisi yang tersedia untuk penetapan kebijakan OS tertentu
• Hapus penetapan kebijakan OS: hapus penetapan kebijakan OS tertentu
• Lakukan debug penetapan kebijakan OS: pecahkan masalah penetapan kebijakan OS

Anda dapat mengelola penetapan kebijakan OS menggunakan konsolCloud de Confiance , Google Cloud CLI, atau OS Config API.

Sebelum memulai

• Tinjau kuota OS Config.
• Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses Cloud de Confiance 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:

  Console

  When you use the Cloud de Confiance console to access Cloud de Confiance by S3NS services and APIs, you don't need to set up authentication.

  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 Cloud de Confiance .

Izin

Pemilik project memiliki akses penuh untuk mengelola penetapan kebijakan OS. Untuk semua pengguna lainnya, Anda harus memberikan izin. Untuk mengelola penetapan kebijakan OS, Anda dapat memberikan salah satu peran terperinci berikut:

• Admin OSPolicyAssignment (roles/osconfig.osPolicyAssignmentAdmin). Berisi izin untuk membuat, menghapus, mengupdate, mendapatkan, dan mencantumkan penetapan kebijakan OS.
• Editor OSPolicyAssignment (roles/osconfig.osPolicyAssignmentEditor). Berisi izin untuk mengupdate, mendapatkan, dan mencantumkan penetapan kebijakan OS.
• Viewer OSPolicyAssignment (roles/osconfig.osPolicyAssignmentViewer). Berisi izin akses hanya baca untuk mendapatkan dan mencantumkan penetapan kebijakan OS.

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member user:USER_ID@gmail.com \
        --role roles/osconfig.osPolicyAssignmentAdmin

Mengupdate penetapan kebijakan OS

Untuk mengupdate penetapan kebijakan OS, selesaikan langkah-langkah berikut:

1. Update file YAML atau JSON yang memiliki penetapan kebijakan OS.

   Permintaan update mendukung mask kolom. Anda mungkin hanya perlu mengupdate kolom tertentu dalam penetapan kebijakan OS dan tidak mengubah kolom lainnya. Perintah update atau patch menggunakan mask kolom untuk memberi tahu API kolom mana yang diubah. Permintaan update atau patch mengabaikan kolom apa pun yang tidak ditentukan di mask kolom, sehingga nilai saat ini tidak berubah. Untuk mengetahui informasi selengkapnya tentang mask kolom, lihat FieldMask.

2. Update penetapan kebijakan OS menggunakan Cloud de Confiance konsol, Google Cloud CLI, atau OS Config API.

   Saat Anda mengupdate penetapan kebijakan OS, peluncuran akan dibuat. Anda dapat melihat progres update dengan memantau peluncuran. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan detail peluncuran.

   Konsol

   1. Di konsol Cloud de Confiance , buka halaman Kebijakan OS > Penetapan.

      Buka Cloud de Confiance konsol

   2. Untuk penetapan kebijakan OS yang ingin diedit, klik Tindakan (more_vert) > Edit Penetapan.

   3. Lakukan update yang diperlukan. Misalnya, Anda dapat mengupload file kebijakan OS yang telah diupdate.

   4. Klik Mulai peluncuran.

   gcloud

   Gunakan perintah os-config os-policy-assignments update untuk mengupdate penetapan kebijakan OS.

   gcloud compute os-config os-policy-assignments update OS_POLICY_ASSIGNMENT_ID \
       --location=ZONE \
       --file=FILE
   

   Ganti kode berikut:

   • OS_POLICY_ASSIGNMENT_ID: nama penetapan kebijakan OS yang ingin Anda update
   • ZONE: zona tempat penetapan kebijakan OS berada

   • FILE: jalur absolut ke file JSON atau YAML yang berisi spesifikasi penetapan kebijakan OS yang diupdate

     Jika penetapan kebijakan OS tidak ada, dan jika Anda menentukan flag --allow-missing, VM Manager akan membuat penetapan kebijakan OS dengan ID dan spesifikasi yang ditentukan.

   REST

   Di API, buat permintaan PATCH ke metode projects.locations.osPolicyAssignments.patch.

   PATCH https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID
   
   {
    JSON_OS_POLICY
   }
   

   Ganti kode berikut:

   • PROJECT_ID: project ID Anda
   • OS_POLICY_ASSIGNMENT_ID: nama penetapan kebijakan OS yang ingin Anda update
   • JSON_OS_POLICY: spesifikasi penetapan kebijakan OS yang dibuat di langkah sebelumnya. Nama ini harus dalam format JSON. Untuk mengetahui informasi selengkapnya tentang parameter dan format, lihat Resource: OSPolicyAssignment.
   • ZONE: zona tempat penetapan kebijakan OS berada

Mencantumkan penetapan kebijakan OS

 gcloud compute os-config os-policy-assignments list \
     --location=ZONE

GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments

Menjelaskan penetapan kebijakan OS

gcloud compute os-config os-policy-assignments describe OS_POLICY_ASSIGNMENT_ID \
     --location=ZONE

GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID

Mencantumkan revisi penetapan kebijakan OS

gcloud compute os-config os-policy-assignments list-revisions OS_POLICY_ASSIGNMENT_ID \
    --location=ZONE

GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID:listRevisions

Menghapus penetapan kebijakan OS

Saat Anda menghapus penetapan kebijakan OS, peluncuran akan dibuat. Anda dapat melihat progres penghapusan dengan memantau peluncuran. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan detail peluncuran.

gcloud compute os-config os-policy-assignments delete OS_POLICY_ASSIGNMENT_ID \
    --location=ZONE

DELETE https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID

Pemecahan masalah

Untuk memecahkan masalah penetapan kebijakan OS, lihat Memecahkan masalah VM Manager.

Apa langkah selanjutnya?

• Pelajari kebijakan OS lebih lanjut.
• Buat penetapan kebijakan OS.