Benachrichtigungsrichtlinien mit Terraform verwalten

In diesem Dokument wird beschrieben, wie Sie mit demGoogle Cloud Terraform-Provider Google Cloud Benachrichtigungsrichtlinien in Ihrem Projekt bearbeiten und löschen. Der Google Cloud Terraform-Provider bietet die folgenden 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:

Diese Funktion wird nur für Google Cloud -Projekte unterstützt. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des für Apps aktivierten Ordners aus.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen 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. Installieren und konfigurieren Sie Terraform für Ihr Projekt. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des für Apps aktivierten Ordners aus.

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

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

  4. Geben Sie in Cloud Shell terraform apply ein.

Konfiguration einer Benachrichtigungsrichtlinie in eine Terraform-Konfiguration exportieren

Sie können eine Konfiguration für Benachrichtigungsrichtlinien aus Google Cloudin eine Terraform-Definition in Ihrer Terraform-Konfiguration exportieren. Dieser Vorgang ist hilfreich, wenn Sie eine Benachrichtigungsrichtlinie in Google Clouderstellt haben, nachdem Sie Ihre Terraform-Konfiguration erstellt haben.

So exportieren Sie Ihre Benachrichtigungsrichtlinie:

  1. Installieren und konfigurieren Sie Terraform für Ihr Projekt. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des für Apps aktivierten Ordners aus.

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

  3. Fügen Sie einer Datei in Ihrer Terraform-Konfiguration einen import-Block hinzu. Der Importblock hat die folgenden Argumente:

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

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

    Sie möchten beispielsweise eine Benachrichtigungsrichtlinie exportieren, die die CPU-Auslastung überwacht. Dazu legen Sie RESOURCE_NAME auf cpu_usage_threshold fest. 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

    Mit dem vorherigen Befehl wird eine Datei namens generated.tf erstellt, in der Sie die Definition der Benachrichtigungsrichtlinie überprüfen können, bevor Sie sie Ihrer Terraform-Konfiguration hinzufügen. Sie können die Definition bearbeiten, in eine andere Datei verschieben oder unverändert lassen.

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

Weitere Informationen zum Generieren von Definitionen für Ressourcen, die nicht Teil Ihrer Terraform-Konfiguration sind, finden Sie unter Konfiguration generieren.

Nächste Schritte