Mengelola kebijakan pemberitahuan dengan Terraform

Dokumen ini menjelaskan cara menggunakan Penyedia Google Cloud Terraform untuk mengedit dan menghapus kebijakan pemberitahuan di project Google Cloud Anda. Penyedia Google Cloud Terraform menyediakan resource berikut untuk kebijakan pemberitahuan dan saluran notifikasi:

Terraform adalah alat untuk mem-build, mengubah, dan membuat versi infrastruktur. Arsitektur aplikasi menggunakan file konfigurasi untuk menjelaskan komponen yang diperlukan untuk menjalankan satu aplikasi atau seluruh infrastruktur Anda. Untuk mengetahui informasi lebih lanjut cara menggunakan Terraform, lihat dokumen berikut:

Sebelum memulai

Untuk mendapatkan izin yang diperlukan untuk mengubah kebijakan pemberitahuan menggunakan Terraform, minta administrator untuk memberi Anda peran IAM Monitoring Editor (roles/monitoring.alertPolicyEditor) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk mengetahui informasi selengkapnya tentang peran Cloud Monitoring, lihat Mengontrol akses dengan Identity and Access Management.

Mengedit atau menghapus kebijakan pemberitahuan

Untuk mengedit atau menghapus kebijakan pemberitahuan di project Google Cloud Anda, lakukan langkah berikut:

  1. Pastikan Terraform terinstal di Cloud Shell.

  2. Di Cloud Shell, buka direktori yang berisi konfigurasi Terraform Anda.

  3. Edit file konfigurasi, cari resource google_monitoring_alert_policy untuk kebijakan pemberitahuan Anda, lalu ubah atau hapus resource tersebut.

  4. Di Cloud Shell, masukkan terraform apply.

Mengekspor konfigurasi kebijakan pemberitahuan ke konfigurasi Terraform

Anda dapat mengekspor konfigurasi kebijakan pemberitahuan dari Google Cloud ke definisi Terraform di konfigurasi Terraform. Proses ini berguna jika Anda membuat kebijakan pemberitahuan di Google Cloud setelah membuat konfigurasi Terraform.

Untuk mengekspor kebijakan pemberitahuan, lakukan hal berikut:

  1. Pastikan Terraform terinstal di Cloud Shell.

  2. Di Cloud Shell, buka direktori yang berisi konfigurasi Terraform Anda.

  3. Tambahkan blok import ke file dalam konfigurasi Terraform. Blok impor memiliki argumen berikut:

    • to: Alamat resource seperti yang ditentukan oleh konfigurasi Terraform Anda. Kolom ini memiliki format google_monitoring_alert_policy.RESOURCE_NAME, dengan RESOURCE_NAME sebagai nilai yang Anda pilih. Sebaiknya pilih nama resource yang menjelaskan kebijakan pemberitahuan Anda dengan jelas.

    • id: Nama kebijakan pemberitahuan. Kolom ini memiliki format project/PROJECT_ID/alertPolicies/ALERT_POLICY_ID.

    Misalnya, Anda ingin mengekspor kebijakan pemberitahuan yang memantau penggunaan CPU, sehingga Anda menetapkan RESOURCE_NAME ke cpu_usage_threshold. Selanjutnya, tetapkan id sebagai nama kebijakan pemberitahuan:

    import {
    to = google_monitoring_alert_policy.cpu_usage_threshold
    id = "projects/my-alerting-project/alertPolicies/7160801095019277297"
    }
    
  4. Jalankan perintah berikut di Cloud Shell:

    terraform plan -generate-config-out=generated.tf
    

    Perintah sebelumnya membuat file bernama generated.tf sehingga Anda dapat meninjau definisi kebijakan pemberitahuan sebelum menambahkannya ke konfigurasi Terraform. Anda dapat mengedit definisi, memindahkannya ke file lain, atau membiarkannya tidak berubah.

  5. Di Cloud Shell, masukkan terraform apply untuk mengimpor definisi kebijakan pemberitahuan Anda ke konfigurasi Terraform.

Untuk mengetahui informasi selengkapnya tentang cara membuat definisi untuk resource yang bukan bagian dari konfigurasi Terraform, lihat Membuat konfigurasi.

Langkah selanjutnya