In diesem Dokument wird beschrieben, wie Sie mit dem Google Cloud Terraform-Anbieter Benachrichtigungsrichtlinien in Ihrem Google Cloud-Projekt bearbeiten und löschen. Der Google Cloud Terraform-Anbieter stellt die folgenden Ressourcen für Benachrichtigungsrichtlinien und Benachrichtigungskanäle bereit:
Terraform ist ein Tool zum Erstellen, Ändern und zur Versionsverwaltung von Infrastruktur. Terraform verwendet Konfigurationsdateien, um die Komponenten zu beschreiben, die zum Ausführen einer einzelnen Anwendung oder Ihrer gesamten Infrastruktur erforderlich sind. Weitere Informationen zur Verwendung von Terraform finden Sie in den folgenden Dokumenten:
- Dokumentation zu Terraform in Google Cloud
- Google Cloud Terraform-Anbieter
- Erste Schritte – Google Cloud
Hinweise
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Editor (roles/monitoring.alertPolicyEditor
) für Ihr Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Ändern von Benachrichtigungsrichtlinien mithilfe von Terraform benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.
Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Weitere Informationen zu Cloud Monitoring-Rollen finden Sie unter Zugriff mit Identity and Access Management steuern.
Benachrichtigungsrichtlinien bearbeiten oder löschen
So bearbeiten oder löschen Sie eine Benachrichtigungsrichtlinie in Ihrem Google Cloud-Projekt:
Prüfen Sie, ob Terraform in Cloud Shell installiert ist.
Wechseln Sie in Cloud Shell zu dem Verzeichnis, das Ihre Terraform-Konfiguration enthält.
Bearbeiten Sie die Konfigurationsdatei, suchen Sie die Ressource
google_monitoring_alert_policy
für Ihre Benachrichtigungsrichtlinie und ändern oder löschen Sie dann diese Ressource.Geben Sie in Cloud Shell
terraform apply
ein.
Konfiguration einer Benachrichtigungsrichtlinie in eine Terraform-Konfiguration exportieren
Sie können die Konfiguration einer Benachrichtigungsrichtlinie aus Google Cloud in eine Terraform-Definition in Ihrer Terraform-Konfiguration exportieren. Dieser Vorgang ist hilfreich, wenn Sie nach dem Erstellen Ihrer Terraform-Konfiguration eine Benachrichtigungsrichtlinie in Google Cloud erstellt haben.
So exportieren Sie Ihre Benachrichtigungsrichtlinie:
Prüfen Sie, ob Terraform in Cloud Shell installiert ist.
Wechseln Sie in Cloud Shell zu dem Verzeichnis, das Ihre Terraform-Konfiguration enthält.
Fügen Sie einer Datei in der Terraform-Konfiguration einen
import
-Block hinzu. Der Importblock hat die folgenden Argumente:to
: Die in Ihrer Terraform-Konfiguration angegebene Ressourcenadresse. Dieses Feld hat das Formatgoogle_monitoring_alert_policy.RESOURCE_NAME
, wobei RESOURCE_NAME ein von Ihnen ausgewählter Wert ist. Wählen Sie einen Ressourcennamen aus, der Ihre Benachrichtigungsrichtlinie klar beschreibt.id
: Der Name der Benachrichtigungsrichtlinie. Dieses Feld hat das Formatproject/PROJECT_ID/alertPolicies/ALERT_POLICY_ID
.
Wenn Sie beispielsweise eine Benachrichtigungsrichtlinie exportieren möchten, die die CPU-Nutzung überwacht, setzen Sie RESOURCE_NAME auf
cpu_usage_threshold
. Anschließend legen Sieid
als Namen der Benachrichtigungsrichtlinie fest:import { to = google_monitoring_alert_policy.cpu_usage_threshold id = "projects/my-alerting-project/alertPolicies/7160801095019277297" }
Führen Sie in Cloud Shell den folgenden Befehl aus:
terraform plan -generate-config-out=generated.tf
Mit dem vorherigen Befehl wird eine Datei mit dem Namen
generated.tf
erstellt, mit der Sie die Definition der Benachrichtigungsrichtlinie prüfen können, bevor Sie sie in die Terraform-Konfiguration aufnehmen. Sie können die Definition bearbeiten, in eine andere Datei verschieben oder unverändert lassen.Geben Sie in Cloud Shell
terraform apply
ein, um die Definition der Benachrichtigungsrichtlinie in die Terraform-Konfiguration zu importieren.
Weitere Informationen zum Generieren von Definitionen für Ressourcen, die nicht Teil der Terraform-Konfiguration sind, finden Sie unter Konfiguration generieren.
Nächste Schritte
- Weitere Informationen zu Terraform
- Codebeispiele testen, die den Google Cloud Terraform-Anbieter mit Cloud Monitoring verwenden.
- Google Cloud Terraform Provider-Repository auf GitHub ansehen
- Melden Sie ein GitHub-Problem, um einen Fehler zu melden oder eine Frage zu Terraform zu stellen.