Benachrichtigungsrichtlinien mit Terraform verwalten

In diesem Dokument wird beschrieben, wie Sie mit dem Google Cloud Terraform-Anbieter Benachrichtigungsrichtlinien in Ihrem Google Cloud-Projekt bearbeiten und löschen. Google Cloud Terraform-Anbieter bietet folgende Ressourcen für Benachrichtigungsrichtlinien und Benachrichtigungskanäle:

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:

Hinweis

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Editor (roles/monitoring.alertPolicyEditor) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ändern von Benachrichtigungsrichtlinien mit Terraform benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können 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:

  1. Prüfen Sie, ob Terraform in Cloud Shell installiert ist.

  2. Wechseln Sie in Cloud Shell zu dem Verzeichnis, das Ihre Terraform-Konfiguration enthält.

  3. Bearbeiten Sie die Konfigurationsdatei und suchen Sie nach der Datei google_monitoring_alert_policy. Ressource für Ihre Benachrichtigungsrichtlinie und ändern oder löschen Sie für diese Ressource.

  4. Geben Sie in Cloud Shell terraform apply ein.

Konfiguration einer Benachrichtigungsrichtlinie in eine Terraform-Konfiguration exportieren

Sie können eine Benachrichtigungsrichtlinienkonfiguration aus Google Cloud in eine Terraform-Definition in Ihrer Terraform-Konfiguration exportieren. Dieser Prozess ist hilfreich, wenn Sie in Google Cloud eine Benachrichtigungsrichtlinie erstellt haben nachdem Sie die Terraform-Konfiguration erstellt haben.

So exportieren Sie Ihre Benachrichtigungsrichtlinie:

  1. Prüfen Sie, ob Terraform in Cloud Shell installiert ist.

  2. Führen Sie in Cloud Shell folgende Schritte aus: Rufen Sie das Verzeichnis auf, das Ihre Terraform-Konfiguration enthält.

  3. import-Block zu einer Datei in Ihrem Terraform-Konfiguration. Der Importblock hat die folgenden Argumente:

    • to: Die Ressourcenadresse, wie in Ihrem Terraform-Konfiguration. Dieses Feld hat das Format google_monitoring_alert_policy.RESOURCE_NAME, wobei RESOURCE_NAME ein von dir ausgewählter Wert ist. Wir empfehlen, einen Ressourcennamen zu wählen, der Ihre Benachrichtigungsrichtlinie klar beschreibt.

    • id: Der Name der Benachrichtigungsrichtlinie. Dieses Feld hat das Format project/PROJECT_ID/alertPolicies/ALERT_POLICY_ID

    Sie können z. B. eine Benachrichtigungsrichtlinie exportieren, die die CPU-Nutzung überwacht, daher setzen Sie RESOURCE_NAME auf cpu_usage_threshold. Legen Sie dann id als Namen der Benachrichtigungsrichtlinie fest:

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

  4. Führen Sie in Cloud Shell den folgenden Befehl aus:

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

    Der vorherige Befehl erstellt eine Datei mit dem Namen generated.tf, mit der Sie Definition der Benachrichtigungsrichtlinie prüfen bevor Sie sie Ihrer Terraform-Konfiguration hinzufügen. Sie können Folgendes bearbeiten: verschieben Sie sie in eine andere Datei oder unverändert lassen.

  5. Geben Sie in Cloud Shell terraform apply ein, um die Definition der Benachrichtigungsrichtlinie in Ihre Terraform-Konfiguration zu importieren.

Weitere Informationen zum Erstellen von Definitionen für Ressourcen, die es nicht Ihrer Terraform-Konfiguration enthalten, finden Sie unter Konfiguration wird generiert.

Nächste Schritte