Mengelola kebijakan pemberitahuan dengan Terraform

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

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

Sebelum memulai

Untuk mendapatkan izin yang diperlukan guna 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 ke project, folder, dan organisasi.

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

Untuk 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, lakukan langkah-langkah berikut:

  1. Pastikan Terraform diinstal di Cloud Shell.

  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. 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 diinstal di Cloud Shell.

  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 dapat mengedit definisi, memindahkannya ke file lain, atau meninggalkannya tanpa perubahan.

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

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

Langkah selanjutnya