Menginstal Agen Operasional selama pembuatan VM

Dokumen ini menjelaskan cara Konsol Google Cloud dapat otomatis menginstal Agen Operasional saat Anda membuat instance VM. Selama proses penginstalan, VM Manager Compute Engine membuat kebijakan OS Agen Operasional yang menginstal agen dan menginstalnya kembali jika diperlukan. VM Manager membantu Anda menjalankan Agen Operasional di VM dan memastikan agen selalu diinstal.

Ringkasan

VM Manager menggunakan kebijakan konfigurasi OS untuk mengelola penginstalan Agen Operasional. Kebijakan konfigurasi diterapkan ke VM menggunakan pemetaan yang disebut ID penetapan, yang terlihat seperti contoh berikut:

goog-ops-agent-v2-x86-template-1-0-0-ZONE

ID penetapan untuk kebijakan OS Agen Operasi terdiri dari komponen berikut:

  • Nama kebijakan: "goog-ops-agent"
  • Template untuk membuat kebijakan: "v2-x86-template"
  • String versi untuk template. Versi, yang dapat berubah seiring waktu, adalah nilai seperti "1-0-0".
  • Zona tempat ID tugas diterapkan, nilai seperti "us-central1-a".

VM dikaitkan dengan ID penetapan menggunakan label pada instance VM. VM Compute Engine adalah resource yang dimonitor dari jenis gce_instance dan mencakup label zone. Saat Anda menggunakan konsol Google Cloud untuk membuat VM dengan Agen Operasional terinstal, VM Manager akan menambahkan label lain ke VM, yang terlihat seperti goog-ops-agent-policy:v2-x86-template-1-0-0. Label ini mengidentifikasi kebijakan, template, dan versi:

  • Kunci label, ID untuk kebijakan: goog-ops-agent-policy
  • Nilai label, template kebijakan, dan versi: v2-x86-template-1-0-0

Saat membuat VM di Google Cloud Console, Anda dapat mencentang kotak Install Ops Agent for Monitoring and Logging. Saat Anda mengklik Create, VM Manager akan memberikan label goog-ops-agent-policy:v2-x86-template-1-0-0 pada VM dan menginstal Agen Operasional. Jika VM adalah VM pertama di zonanya, VM Manager juga akan membuat kebijakan OS Agen Operasional dan penetapan kebijakan OS Agen Operasional untuk zona tersebut.

Meskipun zona memiliki penetapan kebijakan OS Agen Operasional, kebijakan OS Agen Operasional memantau VM yang memiliki karakteristik berikut:

  • VM memiliki label goog-ops-agent-policy:v2-x86-template-1-0-0.
  • VM berada di zona yang sama dengan penetapan kebijakan OS Agen Operasional.

Kebijakan OS Agen Operasional memeriksa setiap jam apakah VM yang tercakup telah menginstal Agen Operasional. Jika Agen Operasional belum diinstal, kebijakan OS Agen Operasional akan menginstal agen versi terbaru.

Membuat VM dengan penginstalan otomatis Agen Operasional

Untuk menginstal Agen Operasional secara otomatis selama pembuatan VM dan menerapkan penetapan kebijakan OS Agen Operasional ke VM, lakukan hal berikut:

  1. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/osconfig.osPolicyAssignmentEditor 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
    • Replace PROJECT_ID with your project ID.

    • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:myemail@example.com.

    • Replace ROLE with each individual role.
  2. Ikuti langkah-langkah di bagian Membuat instance VM dari image publik. Sebelum mengklik Create, centang kotak Install Ops Agent for Monitoring and Logging:

    Kotak centang Instal Ops Agent for Monitoring and Logging.

  3. Klik Create.

    Saat Anda menginstal Agen Operasional secara otomatis untuk pertama kalinya di suatu zona, jika Anda tidak mengaktifkan Pengelola VM untuk project Google Cloud, proses pembuatan VM akan melakukan hal berikut:

    1. Memungkinkan VM Manager beroperasi dalam mode terbatas.
    2. Membuat kebijakan OS Agen Operasional dan penetapan kebijakan OS Agen Operasional untuk zona tersebut. Kebijakan OS Agen Operasional adalah kolom penetapan kebijakan.
    3. Mengaktifkan patch OS, konfigurasi OS, dan pengelolaan inventaris OS dengan menyetel label metadata VM enable-osconfig ke TRUE.
    4. Membuat VM dan menetapkan label kebijakan OS Agen Operasional ke VM.

    Jika Anda membuat VM dan otomatis menginstal Agen Operasional di zona tempat penetapan kebijakan OS Agen Operasional sudah ada, proses pembuatan VM akan membuat VM dan menetapkan label kebijakan OS Agen Operasional ke VM.

Contoh

Project Google Cloud Anda tidak memiliki penetapan kebijakan OS Agen Operasional. Anda membuat dua VM, instance-1 dan instance-2 di zona us-central1-a. Kemudian, buat instance-3 dan instance-4 di zona us-east1-b. Pada instance-1, instance-2, dan instance-3, kotak Install Ops Agent for Monitoring and Logging dicentang selama pembuatan.

  • Saat Anda membuat instance-1, VM Manager akan membuat kebijakan OS Agen Operasional untuk zona us-central1-a dan penetapan kebijakan OS dengan ID goog-ops-agent-v2-x86-template-1-0-0-us-central1-a. VM Manager kemudian menetapkan label kebijakan pada instance-1.
  • Saat Anda membuat instance-2, VM Manager akan menetapkan label kebijakan yang sama pada instance-2.
  • Saat Anda membuat instance-3, VM Manager akan membuat kebijakan OS Agen Operasional untuk zona us-east1-b dan penetapan kebijakan OS dengan ID goog-ops-agent-v2-x86-template-1-0-0-us-east1-b. VM Manager kemudian menetapkan label kebijakan ke instance-3.

Selanjutnya, kebijakan OS Agen Operasional mencakup VM berikut berdasarkan ID penetapan kebijakan OS Agen Operasional:

ID Penetapan Kebijakan OS Mencakup VM Di: VM yang Dicakup
goog-ops-agent-v2-x86-template-1-0-0-us-central1-a us-central1-a instance-1, instance-2
goog-ops-agent-v2-x86-template-1-0-0-us-east1-b us-east1-b instance-3

Secara default, instance-4 tidak tercakup karena Anda tidak memilih Install Ops Agent for Monitoring and Logging, sehingga tidak memiliki label goog-ops-agent-policy:v2-x86-template-1-0-0. Jika Anda juga ingin menerapkan kebijakan OS Agen Operasional ke instance-4, lihat Menambahkan cakupan kebijakan OS Agen Operasional ke VM yang ada.

Mengelola versi Agen Operasional di VM yang dicakup oleh kebijakan OS Agen Operasional

Kebijakan OS Agen Operasional tidak mengupdate Agen Operasional saat versi baru agen dirilis. Selama VM menginstal beberapa versi Agen Operasional yang terinstal, kebijakan tidak akan melakukan apa pun. Jika Anda meng-uninstal Agen Operasional, kebijakan akan mendeteksi bahwa Agen Operasional belum diinstal, lalu menginstal versi terbaru.

Untuk mengupgrade VM ke versi terbaru Agen Operasional, uninstal versi yang saat ini Anda jalankan dan izinkan kebijakan OS Agen Operasional menginstal versi terbaru.

Jika perlu menginstal Agen Operasional versi sebelumnya, Anda dapat meng-uninstal Agen Operasional pada VM yang tercakup dalam kebijakan OS Agen Operasional, lalu menginstal versi agen tertentu.

Pemecahan masalah

Untuk mengetahui informasi tentang cara memecahkan masalah penginstalan agen dan kebijakan OS Agen Operasional, lihat Mengelola VM yang dicakup oleh kebijakan OS Agen Operasional dan Alat diagnostik agen untuk kebijakan penginstalan otomatis.

Harga

Kebijakan OS adalah alat generik untuk menginstal paket. Secara default, jika VM Manager diaktifkan karena Anda telah membuat VM dengan Agen Operasional yang diinstal otomatis, VM Manager akan diaktifkan dalam mode terbatas. Untuk mengetahui informasi tentang mode dan harga VM Manager, baca artikel Harga VM Manager.

Langkah selanjutnya

Untuk mengetahui informasi tentang cara mengelola VM yang tercakup dalam kebijakan OS Agen Operasional, baca artikel Mengelola VM yang dicakup oleh kebijakan OS Agen Operasional.