Mengelola kebijakan pemberitahuan dengan Terraform

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

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

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

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 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 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-langkah berikut:

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

  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 folder yang mendukung aplikasi.

  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 jelas mendeskripsikan kebijakan pemberitahuan Anda.

    • 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, jadi 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 membiarkannya tidak berubah.

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

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

Langkah berikutnya

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