Mengelola kebijakan pemberitahuan dengan Terraform

Google Cloud Terraform Provider memungkinkan Anda mengedit, menghapus, dan mengekspor kebijakan pemberitahuan di project Google Cloud Anda. Anda mengonfigurasi kebijakan pemberitahuan dan saluran notifikasi menggunakan google_monitoring_alert_policy dan google_monitoring_notification_channel resource.

Terraform menggunakan file konfigurasi untuk membuat, mengubah, dan membuat versi komponen yang diperlukan untuk menjalankan satu aplikasi atau seluruh infrastruktur Anda. Untuk mengetahui informasi selengkapnya tentang penggunaan Terraform, lihat dokumentasi Google Cloud Terraform, referensi Google Cloud Terraform Provider, dan Mulai - Google Cloud.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan untuk mengubah kebijakan pemberitahuan menggunakan Terraform, minta administrator Anda untuk memberi Anda peran IAM berikut di project Anda:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

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. Instal dan konfigurasi Terraform untuk project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan.

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

  3. Edit file konfigurasi, temukan 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 dalam konfigurasi Terraform Anda. Proses ini berguna jika Anda membuat kebijakan pemberitahuan di Google Cloud setelah membuat konfigurasi Terraform.

Untuk mengekspor kebijakan pemberitahuan, lakukan langkah berikut:

  1. Instal dan konfigurasi Terraform untuk project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan.

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

  3. Tambahkan blok import ke file dalam konfigurasi Terraform Anda. 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 adalah 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. Kemudian, Anda menetapkan id sebagai nama kebijakan pemberitahuan:

    import {
to = google_monitoring_alert_policy.cpu_usage_threshold
id = "projects/my-alerting-project/alertPolicies/7160801095019277297"
}

  4. Di Cloud Shell, jalankan perintah berikut:

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

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

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

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

Langkah berikutnya

  • Pelajari lebih lanjut tentang Terraform.
  • Coba contoh kode yang menggunakan Google Cloud Terraform Provider dengan Cloud Monitoring.
  • Lihat repositori Google Cloud Terraform Provider di GitHub.
  • Buatlah laporan masalah GitHub untuk melaporkan bug atau mengajukan pertanyaan tentang Terraform.