Melihat, mengedit, dan menghapus orkestrator kebijakan

Pratinjau

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

Halaman ini menjelaskan cara melihat dan menghapus orkestrator kebijakan di folder atau organisasi Anda.

Sebelum memulai

• Tinjau penetapan kebijakan OS dan kebijakan OS.
• Tinjau kuota OS Config.
• Pastikan Anda memenuhi prasyarat untuk menggunakan orchestrator kebijakan.
• Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi 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. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  REST

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

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

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

Mencantumkan semua orkestrator kebijakan dalam folder

Untuk melihat semua orkestrator kebijakan dalam folder, selesaikan langkah-langkah berikut:

Konsol

Untuk mencantumkan orkestrator kebijakan dalam folder, lakukan hal berikut:

1. Di Konsol Google Cloud, buka halaman Kebijakan OS.

   Buka kebijakan OS

2. Klik Project Selector di panel tindakan konsol Google Cloud dan pilih folder tempat Anda ingin membuat orchestrator kebijakan.

3. Klik Policy Orchestrators.

gcloud

Untuk melihat detail orchestrator kebijakan yang dibuat dalam folder, jalankan perintah beta os-config policy-orchestrators list:

  gcloud --billing-project=QUOTA_PROJECT_ID beta compute os-config policy-orchestrators list \
    --folder=FOLDER_NUMBER \

Ganti kode berikut:

• QUOTA_PROJECT_ID: project ID kuota atau project penagihan.
• FOLDER_NUMBER: ID numerik folder tempat Anda membuat orkestrator kebijakan.

Contoh

  gcloud beta compute os-config policy-orchestrators list \
    --folder=123456 \

REST

Untuk melihat semua orkestrator kebijakan dalam folder, kirim permintaan GET ke metode folders.locations.global.policyOrchestrators.list:

GET https://osconfig.googleapis.com/v2beta/folders/FOLDER_NUMBER/locations/global/policyOrchestrators
-H "x-goog-user-project: QUOTA_PROJECT_ID"

Ganti FOLDER_NUMBER dengan ID numerik folder tempat Anda membuat orkestrator kebijakan.

Melihat detail orkestrator kebijakan

Untuk melihat detail orkestrator kebijakan di folder, selesaikan langkah-langkah berikut:

Konsol

Untuk melihat orkestrator kebijakan, lakukan langkah berikut:

1. Di Konsol Google Cloud, buka halaman Kebijakan OS.

   Buka kebijakan OS

2. Klik Project Selector di panel tindakan konsol Google Cloud dan pilih folder tempat Anda ingin membuat orchestrator kebijakan.

3. Klik Policy Orchestrators.

4. Pilih nama orkestrator kebijakan yang ingin Anda lihat. Halaman Orchestrator details akan terbuka.

5. Untuk melihat detail kebijakan OS yang diterapkan ke VM, klik OS Policy Template.

gcloud

Untuk melihat detail orchestrator kebijakan yang dibuat dalam folder, jalankan perintah beta os-config policy-orchestrators describe:

gcloud --billing-project=QUOTA_PROJECT_ID beta compute os-config policy-orchestrators describe ORCHESTRATOR_NAME \
  --folder=FOLDER_NUMBER \

Ganti kode berikut:

• QUOTA_PROJECT_ID: project ID kuota atau project penagihan.
• ORCHESTRATOR_NAME: nama untuk orkestrator kebijakan.
• FOLDER_NUMBER: ID numerik folder tempat Anda membuat orkestrator kebijakan.

Contoh

  gcloud --billing-project=my-quota-project beta compute os-config policy-orchestrators describe my-os-policy-orchestrator \
      --folder=123456 \

REST

Untuk melihat detail orkestrator kebijakan, kirim permintaan GET ke metode folders.locations.global.policyOrchestrators.get,

GET https://osconfig.googleapis.com/v2beta/folders/FOLDER_NUMBER/locations/global/policyOrchestrators/ORCHESTRATOR_NAME
-H "x-goog-user-project: QUOTA_PROJECT_ID"

Ganti kode berikut:

• QUOTA_PROJECT_ID: project ID kuota atau project penagihan.
• FOLDER_NUMBER: ID numerik folder tempat orkestrator kebijakan berada.
• ORCHESTRATOR_NAME: nama orchestrator kebijakan yang ingin Anda hapus.

Isi permintaan harus kosong.

Mengedit orkestrator kebijakan

Anda dapat mengubah orkestrator kebijakan untuk menambahkan atau memperbarui penetapan kebijakan OS, cakupan orkestrator, dan resource.

Konsol

Untuk mengubah setelan orkestrator kebijakan, lakukan hal berikut:

1. Di Konsol Google Cloud, buka halaman Kebijakan OS.

   Buka kebijakan OS

2. Klik Project Selector di panel tindakan konsol Google Cloud dan pilih folder tempat Anda ingin membuat orchestrator kebijakan.

3. Klik Policy Orchestrators.

4. Pilih nama orkestrator kebijakan yang ingin Anda edit. Halaman Orchestrator details akan terbuka.

5. Klik Edit.

6. Di bagian Kebijakan OS, upload file kebijakan OS.

7. Opsional: Di bagian Status, pilih salah satu opsi berikut untuk menentukan perilaku orchestrator kebijakan:

   • ACTIVE: Setelah dibuat, orchestrator kebijakan akan langsung mengambil tindakan.
   • STOPPED: Orkestrator kebijakan yang dibuat dalam status ini tidak akan langsung mengambil tindakan apa pun. Anda dapat mengedit orkestrator kebijakan nanti untuk mengubah statusnya.

8. Di bagian Cakupan orkestrasi, tentukan folder dan project tempat Anda ingin meluncurkan kebijakan OS. Anda hanya boleh memasukkan angka project dan angka folder di kolom ini. Misalnya, 123456, 7654321.

9. Opsional: Pilih zona yang berisi VM yang ingin Anda terapkan kebijakan OS.

10. Opsional: Di bagian Target VM instances, tentukan VM target tempat Anda ingin menerapkan kebijakan OS.

    • Pilih kelompok OS.

    • Anda dapat memfilter VM lebih lanjut dengan menentukan label penyertaan dan pengecualian.

      Misalnya, Anda dapat memilih semua VM Ubuntu di lingkungan pengujian Anda, dan mengecualikan VM yang menjalankan Google Kubernetes Engine, dengan menentukan hal berikut:

      • Grup OS: ubuntu
      • Sertakan: env:test, env:staging
      • Kecualikan: goog-gke-node

11. Tentukan rencana peluncuran.

    • Tentukan ukuran gelombang (disebut juga sebagai anggaran gangguan). Contoh, 10%.
    • Menentukan waktu tunggu. Misalnya, 15 menit.

12. Klik Simpan.

gcloud

Untuk mengupdate orkestrator kebijakan di folder, selesaikan langkah-langkah berikut:

1. Gunakan perintah beta os-config policy-orchestrators update untuk mengedit orkestrator kebijakan di folder yang ditentukan.

     gcloud --billing-project=QUOTA_PROJECT_ID beta compute os-config policy-orchestrators update ORCHESTRATOR_NAME \
       --folder=FOLDER_NUMBER \
       --state=stopped
   

   Ganti kode berikut:

   • QUOTA_PROJECT_ID: project ID kuota atau project penagihan.
   • ORCHESTRATOR_NAME: nama untuk orkestrator kebijakan. Lihat Konvensi penamaan resource.
   • FOLDER_NUMBER: ID folder numerik dari folder tempat orkestrator kebijakan berada.

   Contoh

     gcloud --billing-project=my-quota-project beta compute os-config policy-orchestrators update my-os-policy-orchestrator \
       --folder=123456 \
       --include-projects=5432134,4567890
   

REST

Untuk mengupdate orkestrator kebijakan dalam folder, selesaikan langkah-langkah berikut, kirim permintaan PATCH ke metode folders.locations.global.policyOrchestrators.patch.

Dalam isi permintaan, edit spesifikasi penetapan kebijakan OS.

    PATCH https://osconfig.googleapis.com/v2beta/folders/FOLDER_NUMBER/locations/global/policyOrchestrators/ORCHESTRATOR_NAME
    -H "x-goog-user-project: QUOTA_PROJECT_ID"

      {
        JSON_OS_POLICY_ORCHESTRATOR
      }

Ganti kode berikut:

• QUOTA_PROJECT_ID: project ID project kuota atau penagihan
• FOLDER_NUMBER: ID numerik folder tempat orkestrator kebijakan berada.
• ORCHESTRATOR_NAME: nama orchestrator kebijakan yang ingin Anda edit.
• JSON_OS_POLICY_ORCHESTRATOR: objek orchestrator kebijakan dalam format JSON yang menentukan cakupan orchestrator, resource yang diorkestrasi, dan status orkestrasi. Untuk mengetahui informasi selengkapnya tentang parameter dan format, lihat Resource: folders.locations.global.policyOrchestrators.

Menghapus orkestrator kebijakan

Catatan: Menghapus orchestrator kebijakan hanya akan menghapus resource orchestrator kebijakan dari cakupan yang ditentukan, bukan penetapan kebijakan OS yang diterapkan pada resource zona. Jika Anda ingin menghapus penetapan kebijakan OS yang dibuat oleh orkestrator kebijakan, edit orkestrator terlebih dahulu dan ubah action-nya menjadi delete. Setelah orkestrator menghapus penetapan kebijakan OS, hapus orkestrator.

Untuk menghapus orkestrator kebijakan dan membatalkan semua peluncuran yang sedang berlangsung, selesaikan langkah-langkah berikut:

Konsol

Untuk menghapus orkestrator kebijakan, lakukan langkah-langkah berikut:

1. Di Konsol Google Cloud, buka halaman Kebijakan OS.

   Buka kebijakan OS

2. Klik Project Selector di panel tindakan konsol Google Cloud dan pilih folder tempat Anda ingin membuat orchestrator kebijakan.

3. Klik Policy Orchestrators.

4. Pilih nama orkestrator kebijakan yang ingin Anda hapus. Halaman Orchestrator details akan terbuka.

5. Klik Hapus.

gcloud

Untuk menghapus orchestrator kebijakan dari folder, lakukan tindakan berikut:

1. Gunakan perintah beta os-config policy-orchestrators delete:

     gcloud --billing-project=QUOTA_PROJECT_IDbeta compute os-config policy-orchestrators delete ORCHESTRATOR_NAME \
       --folder=FOLDER_NUMBER \
       --policy-id=POLICY_ID
   

   Ganti kode berikut:

   • QUOTA_PROJECT_ID: project ID kuota atau project penagihan.
   • ORCHESTRATOR_NAME: nama untuk orkestrator kebijakan.
   • FOLDER_NUMBER: ID numerik folder tempat Anda membuat orkestrator kebijakan.
   • POLICY_ID: ID yang ditetapkan ke orkestrator kebijakan.

   Contoh

     gcloud --billing-project=my-quota-project beta compute os-config policy-orchestrators create my-os-policy-orchestrator \
       --folder=123456 \
       --policy-id=my-policy
   

REST

Untuk menghapus orkestrator kebijakan di folder, kirim permintaan DELETE ke metode folders.locations.global.policyOrchestrators.delete:

DELETE https://osconfig.googleapis.com/v2beta/folders/FOLDER_NUMBER/locations/global/policyOrchestrators/ORCHESTRATOR_NAME
-H "x-goog-user-project: QUOTA_PROJECT_ID"

Ganti kode berikut:

• QUOTA_PROJECT_ID: project ID kuota atau project penagihan.
• FOLDER_NUMBER: ID numerik folder tempat orkestrator kebijakan berada.
• ORCHESTRATOR_NAME: nama orchestrator kebijakan yang ingin Anda hapus.

Apa langkah selanjutnya?

• Pelajari cara mengelola penetapan kebijakan OS menggunakan orchestrator kebijakan.