Mengelola kebijakan pemberitahuan dengan Terraform

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

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

Fitur ini hanya didukung untuk Google Cloud project. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan.

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 hal 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 hal 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, tetapkan 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