Ringkasan kebijakan agen untuk Agen Operasional

Kebijakan agen memungkinkan penginstalan dan pemeliharaan otomatis Agen Operasional di seluruh fleet VM Compute Engine yang cocok kriteria yang ditentukan pengguna. Dengan satu perintah, Anda bisa membuat kebijakan untuk sebuah Project Google Cloud yang mengatur VM yang ada dan baru yang terkait dengan VM tersebut project Google Cloud guna memastikan penginstalan dan uninstal Agen Operasional VM tersebut.

Kebijakan agen untuk Agen Operasional

Dukungan untuk kebijakan agen bagi Agen Operasional tersedia di Google Cloud SDK di dua tingkat rilis: GA dan beta. Kedua jenis kebijakan ini bergantung pada OS Config yang disediakan oleh VM Manager, tetapi implementasinya berbeda. Sebaiknya gunakan kebijakan GA jika memungkinkan. Dalam kebanyakan kasus, Anda dapat mengonversi kebijakan beta ke kebijakan GA.

Bagian ini menjelaskan perbedaan antara kebijakan agen versi beta dan GA Untuk informasi tentang cara membuat dan mengelola kebijakan agen, lihat referensi berikut:

Perbedaan antara kebijakan agen beta dan GA

Kebijakan agen yang dibuat oleh versi beta dan GA compute instances ops-agents policies grup perintah berbeda di cara berikut:

  • Dukungan untuk agen Monitoring lama dan agen Logging

    • Kebijakan agen beta dapat mengelola agen Monitoring dan agen Logging lama serta Agen Operasional.
    • Kebijakan agen GA hanya mengelola Agen Operasional.

  • Upgrade otomatis versi agen

    • Kebijakan agen beta dapat membuat agen selalu versi terbaru dengan mengupgrade agen.
    • Kebijakan agen GA tidak mendukung operasi upgrade otomatis. Sebagai pendekatan alternatif, melihat Ganti kebijakan upgrade agen beta.

  • Penerapan kebijakan pada instance Compute Engine yang diberi nama

  • Penerapan global atau zona untuk kebijakan agen dalam project Google Cloud

    • Kebijakan agen beta diterapkan secara global ke semua instance yang dipilih oleh kriteria kebijakan dalam project Google Cloud Anda.
    • Kebijakan agen GA diterapkan ke semua instance yang dipilih oleh kriteria kebijakan dalam zona yang ditentukan oleh kebijakan. Misalnya, kebijakan yang dibuat di zona us-central1-a tidak berpengaruh pada VM di zona lain.

Grup perintah compute instances ops-agents policies beta dan GA juga berbeda secara struktural:

  • Perintah gcloud beta compute instances ops-agents policies menjelaskan kebijakan agen dengan meneruskan opsi individual ke perintah, misalnya:

    gcloud beta compute instances ops-agents policies create ops-agents-test-policy \
  --agent-rules="type=logging,enable-autoupgrade=false;type=metrics,enable-autoupgrade=false" \
  --description="A test policy." \
  --os-types=short-name=centos,version=7 \
  --instances=zones/us-central1-a/instances/test-instance \
  --project PROJECT_ID

  • Perintah gcloud compute instances ops-agents policies menjelaskan kebijakan agen dengan menggunakan konfigurasi YAML file dan zona, misalnya:

    gcloud compute instances ops-agents policies create test-policy \
  --zone us-central1-a \
  --file test-policy.yaml \
  --project PROJECT_ID

Penggunaan kebijakan beta dan GA

Anda dapat menggunakan kebijakan agen versi beta dan GA dengan Agen Operasional, asalkan Anda pertimbangkan perbedaan antara jenis kebijakan.

Perbedaan perilaku terbesar antara kebijakan agen versi beta dan GA adalah GA kebijakan bersifat zona, dan kebijakan agen beta tersedia secara global dalam suatu project. Artinya, kebijakan agen GA hanya memilih VM di zona tempat dibuat, tetapi kebijakan beta dapat memilih VM apa pun di project Google Cloud Anda.

Jika kebijakan beta memilih satu kumpulan VM dan kebijakan GA, pilih kumpulan VM yang berbeda, maka kebijakan tersebut tidak boleh bertentangan.

Anda dapat memiliki kebijakan agen GA dan beta yang berlaku untuk VM yang sama, tetapi perlu memastikan bahwa kebijakan tersebut tidak memiliki tujuan yang bertentangan, misalnya, kebijakan beta yang menginstal Agen Operasional dan kebijakan GA yang meng-uninstal Agen Operasional.

Mengubah kebijakan beta menjadi kebijakan GA

Anda dapat mengubah kebijakan agen versi beta Agen Operasional menjadi kebijakan agen GA, sebagai selama tidak ada perbedaan antara jenis kebijakan yang Anda tidak dapat mengatasinya. Anda tidak dapat mengonversi kebijakan agen beta untuk versi lama Agen pemantauan atau Agen logging terhadap kebijakan agen GA.

Untuk mengonversi kebijakan agen beta menjadi kebijakan GA, lakukan hal berikut:

  1. Buat daftar semua kebijakan agen beta di project Anda dengan menjalankan perintah berikut:

    gcloud beta compute instances ops-agents policies list --project PROJECT_ID

  2. Identifikasi kebijakan agen beta yang ingin Anda konversi ke kebijakan GA.

  3. Untuk setiap kebijakan beta yang Anda identifikasi untuk konversi, lakukan hal berikut:

    1. Membuat file konfigurasi YAML yang mendekati kebijakan beta mungkin, mengingat perbedaan antara kebijakan beta dan GA. Untuk mengetahui informasi tentang format konfigurasi YAML, lihat Jelaskan kebijakan agen.

    2. Buat kebijakan agen GA di setiap zona tempat kebijakan diperlukan. Untuk informasi tentang cara membuat kebijakan agen GA, lihat Buat kebijakan agen.

    3. Hapus kebijakan agen beta dengan menjalankan perintah berikut:

      gcloud beta compute instances ops-agents policies delete POLICY_ID --project PROJECT_ID

Anda mungkin tidak dapat menulis kebijakan agen GA untuk Agen Operasional yang sama persis dengan kebijakan agen beta yang sudah ada. Namun, dengan pengecualian opsi upgrade otomatis dari kebijakan agen beta, Anda bisa mendapatkan perilaku model.

Bagian berikut menjelaskan cara menangani kasus berikut:

Mengonversi kebijakan instance bernama versi beta menjadi kebijakan GA

Untuk mengonversi kebijakan agen beta yang diterapkan ke kumpulan VM bernama Anda dapat melakukan tindakan berikut:

  1. Terapkan label ke instance di kumpulan VM yang ingin Anda pilih. Untuk menerapkan label ke VM yang ada, gunakan perintah gcloud compute instances add-labels. seperti yang ditunjukkan dalam perintah berikut:

    gcloud compute instances add-labels INSTANCE_NAME --labels=KEY=VALUE

  2. Menjelaskan kebijakan agen GA yang memilih VM dengan label baru menggunakan struktur instanceFilter di konfigurasi Anda. Contoh berikut akan membuat file bernama config.yaml yang berisi kebijakan yang cocok dengan label yang diterapkan dalam langkah:

    cat > config.yaml << EOF
agentsRule:
  packageState: installed
  version: 2.47.0
instanceFilter:
  inclusionLabels:
  - labels:
    KEY: VALUE
EOF

    Untuk informasi selengkapnya tentang cara menjelaskan kebijakan agen GA, lihat File konfigurasi untuk kebijakan agen.

  3. Buat kebijakan agen GA di setiap zona yang memiliki VM dengan label baru:

    gcloud compute instances ops-agents policies create POLICY_ID \
  --zone ZONE \
  --file config.yaml
  --project PROJECT_ID

    Untuk informasi selengkapnya tentang cara membuat kebijakan agen GA, lihat Buat kebijakan agen.

Mengganti kebijakan upgrade agen beta

Untuk mengganti kebijakan agen beta yang mengupgrade agen, Anda memiliki hal berikut opsi:

  • Untuk memastikan Agen Operasional selalu yang terbaru, gunakan OS Patch untuk membuat dan menjalankan Tugas Patch OS yang membuat agen selalu terbaru .

  • Untuk melakukan upgrade satu kali, lakukan hal berikut:

    1. Tentukan versi terbaru Agen Operasional dengan berkonsultasi catatan rilis tentang Agen Operasional GitHub.

    2. Buat atau ubah kebijakan agen yang menginstal versi agen terbaru. Misalnya, jika versi terbaru adalah 0f03a99be6d2db0d853bb0e91bbcc0793c0a5012, maka Anda dapat menggunakan YAML kebijakan agen yang terlihat seperti berikut:

      agentsRule:
  packageState: installed
  version: 0f03a99be6d2db0d853bb0e91bbcc0793c0a5012
instanceFilter:
[...]

    3. Terapkan kebijakan ini ke VM di setiap zona.

Sistem operasi yang didukung

Anda dapat menerapkan kebijakan agen ke Compute Engine Instance VM yang menjalankan sistem operasi ditampilkan dalam tabel berikut:

Sistem operasi Agen Operasional
(Kebijakan GA &beta†) 		Agen logging
(hanya kebijakan † beta) 		Agen pemantauan
(hanya kebijakan † beta)
CentOS 8
Linux 8 Rocky
RHEL 6
RHEL 7:
rhel-7, rhel-7-6-sap-ha, rhel-7-7-sap-ha, rhel-7-9-sap-ha		 ‡
RHEL 8:
rhel-8, rhel-8-4-sap-ha, rhel-8-6-sap-ha, rhel-8-8-sap-ha		 ‡
Debian 9 (Peregangan)
Debian 11 (Bullseye)
Deep Learning VM Image berdasarkan Debian 11 (Bullseye)
Ubuntu LTS 18.04 (Bionic Berang-berang):
ubuntu-1804-lts, ubuntu-minimal-1804-lts
Ubuntu LTS 20.04 (Focal Fossa):
ubuntu-2004-lts, ubuntu-minimal-2004-lts
Ubuntu LTS 22.04 (Jammy Jellyfish):
buntu-2204-lts, ubuntu-minimal-2204-lts
SLES 12:
sles-12, sles-12-sp5-sap
SLES 15:
sles-15, sles-15-sp2-sap, sles-15-sp3-sap, sles-15-sp4-sap, sles-15-sp5-sap, sles-15-sp6-sap
OpenSUSE Leap 15:
opensuse-leap (opensuse-leap-15-3-*,
opensuse-leap-15-4-*)
Windows Server:
2016, 2019, 2022, Core 2016, Core 2019, Core 2022
†  Dalam kebijakan agen versi beta, kolom agen dipetakan ke jenis agen yang ditetapkan ke Pemanggilan gcloud beta compute instances ops-agents policies create:
  • Agen Operasional dipetakan ke jenis agen ops-agent.
  • Agen logging dipetakan ke jenis agen logging.
  • Agen pemantauan dipetakan ke jenis agen metrics.
‡ Agen Pemantauan tidak didukung di rhel-7-9-sap-ha, rhel-8-2-sap-ha, atau rhel-8-4-sap-ha.

Langkah selanjutnya

Untuk informasi tentang penggunaan kebijakan agen guna mengelola Agen Operasional, lihat berikut ini: