Clusterbenachrichtigungen erhalten


Auf dieser Seite erfahren Sie, wie Sie mit Pub/Sub Benachrichtigungen über Ihre GKE-Cluster (Google Kubernetes Engine) erhalten.

Übersicht

Wenn bestimmte Ereignisse auftreten, die für Ihre GKE-Cluster relevant sind, z. B. wichtige geplante Upgrades oder verfügbare Sicherheitsbulletins, veröffentlicht GKE Benachrichtigungen zu diesen Ereignissen als Nachrichten in von Ihnen konfigurierten Pub/Sub-Themen. Sie können diese Benachrichtigungen über ein Pub/Sub-Abo erhalten, den Dienst von Drittanbietern einbinden und nach den Benachrichtigungstypen filtern, die Sie erhalten möchten.

Weitere Informationen zu den Vorteilen von Clusterbenachrichtigungen, zur Funktionsweise von Benachrichtigungen und dazu, warum das Filtern wichtig ist, finden Sie unter Clusterbenachrichtigungen. Sie können Clusterbenachrichtigungen in neuen und vorhandenen Standardclustern oder durch Aktualisieren vorhandener Autopilot-Cluster konfigurieren.

Hinweis

Führen Sie die folgenden Aufgaben aus, bevor Sie beginnen:

  • Aktivieren Sie die Google Kubernetes Engine API.
  • Google Kubernetes Engine API aktivieren
  • Wenn Sie die Google Cloud CLI für diese Aufgabe verwenden möchten, müssen Sie die gcloud CLI installieren und dann initialisieren. Wenn Sie die gcloud CLI bereits installiert haben, rufen Sie die neueste Version mit gcloud components update ab.

Clusterbenachrichtigungen in einem neuen Cluster aktivieren

Sie können GKE-Clusterbenachrichtigungen für einen neuen Standardcluster über die Google Cloud CLI oder die Google Cloud Console aktivieren. Wenn Sie Benachrichtigungen für Autopilot-Cluster aktivieren möchten, müssen Sie zuerst einen Autopilot-Cluster erstellen und dann den Cluster so aktualisieren, dass Clusterbenachrichtigungen verwendet werden.

gcloud

Führen Sie folgenden Befehl aus, um Clusterbenachrichtigungen in einem neuen Cluster zu aktivieren:

gcloud container clusters create CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --notification-config=pubsub=ENABLED,pubsub-topic=projects/PROJECT_ID/topics/TOPIC_NAME,filter=NOTIFICATION_TYPE

Dabei gilt:

  • CLUSTER_NAME ist der Name des neuen Clusters.
  • COMPUTE_REGION ist die Computing-Region für Ihren neuen Cluster. Verwenden Sie für zonale Standardcluster --zone=COMPUTE_ZONE.
  • PROJECT_ID ist Ihre Google Cloud-Projekt-ID.
  • TOPIC_NAME ist der Name Ihres Pub/Sub-Themas.
  • NOTIFICATION_TYPE ist eine durch einen senkrechten Strich (|) getrennte Liste der Benachrichtigungstypen, die Sie erhalten möchten. filter="UpgradeEvent|SecurityBulletinEvent" sendet beispielsweise nur UpgradeEvent- und SecurityBulletinEvent-Benachrichtigungen und ignoriert alle anderen Typen.

Console

So aktivieren Sie Clusterbenachrichtigungen für einen neuen Standardcluster:

  1. Rufen Sie in der Google Cloud Console die Seite Google Kubernetes Engine auf.

    Zur Seite „Google Kubernetes Engine“

  2. Klicken Sie auf Erstellen.

  3. Klicken Sie im Dialogfeld Cluster erstellen neben GKE-Standard auf Konfigurieren.

  4. Klicken Sie im Navigationsbereich im Abschnitt Cluster auf Automatisierung.

  5. Markieren Sie das Kästchen Benachrichtigungen aktivieren.

  6. Wählen Sie in der Drop-down-Liste das von Ihnen erstellte Pub/Sub-Thema aus.

  7. Wenn Sie Benachrichtigungen filtern möchten, markieren Sie das Kästchen Benachrichtigungstypen filtern und wählen dann die Benachrichtigungstypen, die Sie erhalten möchten.

  8. Fahren Sie mit der Konfiguration des Clusters wie gewünscht fort.

  9. Klicken Sie auf Erstellen.

Nach der Aktivierung von Benachrichtigungen erstellen Sie ein Pub/Sub-Abo für Ihr Thema.

Clusterbenachrichtigungen für einen vorhandenen Cluster aktivieren

Sie können GKE-Clusterbenachrichtigungen für einen vorhandenen Cluster mithilfe der Google Cloud CLI oder der Google Cloud Console aktivieren.

gcloud

Führen Sie folgenden Befehl aus, um Clusterbenachrichtigungen in einem vorhandenen Cluster zu aktivieren:

gcloud container clusters update CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --notification-config=pubsub=ENABLED,pubsub-topic=projects/PROJECT_ID/topics/TOPIC_NAME,filter=NOTIFICATION_TYPE

Dabei gilt:

  • CLUSTER_NAME: Der Name Ihres Clusters.
  • COMPUTE_REGION ist die Computing-Region für Ihren neuen Cluster. Verwenden Sie für zonale Standardcluster --zone=COMPUTE_ZONE.
  • PROJECT_ID ist Ihre Google Cloud-Projekt-ID.
  • TOPIC_NAME ist der Name Ihres Pub/Sub-Themas.
  • NOTIFICATION_TYPE ist eine durch einen senkrechten Strich (|) getrennte Liste der Benachrichtigungstypen, die Sie erhalten möchten. filter="UpgradeEvent|SecurityBulletinEvent" sendet beispielsweise nur UpgradeEvent- und SecurityBulletinEvent-Benachrichtigungen und ignoriert alle anderen Typen.

Console

So aktivieren Sie Clusterbenachrichtigungen für einen vorhandenen Cluster:

  1. Rufen Sie in der Google Cloud Console die Seite Google Kubernetes Engine auf.

    Zur Seite "Google Kubernetes Engine"

  2. Klicken Sie auf den Namen des Clusters, den Sie ändern möchten.

  3. Klicken Sie unter Automatisierung neben Benachrichtigungen auf Benachrichtigungen bearbeiten.

  4. Markieren Sie im Dialogfeld Benachrichtigungen bearbeiten das Kästchen Benachrichtigungen aktivieren.

  5. Wählen Sie in der Drop-down-Liste das von Ihnen erstellte Pub/Sub-Thema aus.

  6. Wenn Sie Benachrichtigungen filtern möchten, markieren Sie das Kästchen Benachrichtigungstypen filtern und wählen dann die Benachrichtigungstypen, die Sie erhalten möchten.

  7. Klicken Sie auf Änderungen speichern.

Nach der Aktivierung von Benachrichtigungen erstellen Sie ein Pub/Sub-Abo für Ihr Thema.

Clusterbenachrichtigungen filtern

Sie können Benachrichtigungen nach Benachrichtigungstyp filtern, um zu prüfen, ob Sie die gewünschten Benachrichtigungen erhalten.

Sie können Benachrichtigungen mit folgenden Methoden filtern:

  • GKE Geben Sie Werte für filter im --notification-config-Flag an, wie in den vorherigen Beispielen zum Aktivieren von Clusterbenachrichtigungen gezeigt.
  • Pub/Sub: Konfigurieren Sie Ihr Pub/Sub-Abo bei dessen Erstellung so, dass Nachrichten gefiltert werden.

Vorhandene Filter in GKE ändern

Folgen Sie der Anleitung unter Benachrichtigungen für einen vorhandenen Cluster aktivieren und geben Sie die neuen Benachrichtigungstypen zum Filtern im gcloud-Befehl an, um Ihre vorhandenen GKE-Clusterbenachrichtigungsfilter zu ändern, oder wählen Sie die neuen Typen in der Google Cloud Console aus.

Filter in GKE deaktivieren

Sie können Ihre GKE-Benachrichtigungsfilter deaktivieren und alle für Ihren Cluster geltenden Benachrichtigungstypen über die gcloud CLI oder die Google Cloud Console erhalten.

gcloud

Führen Sie folgenden Befehl aus, um Filter mit der gcloud CLI zu deaktivieren:

gcloud container clusters update CLUSTER_NAME \
  --region=COMPUTE_REGION \
  --notification-config=pubsub=ENABLED,pubsub-topic=projects/PROJECT_ID/topics/TOPIC_NAME

Console

So deaktivieren Sie Filter mithilfe der Google Cloud Console:

  1. Rufen Sie in der Google Cloud Console die Seite Google Kubernetes Engine auf.

    Zur Seite "Google Kubernetes Engine"

  2. Klicken Sie auf den Namen des Clusters, den Sie ändern möchten.

  3. Klicken Sie unter Automatisierung neben Benachrichtigungen auf Benachrichtigungen bearbeiten.

  4. Entfernen Sie im Dialogfeld Benachrichtigungen bearbeiten das Häkchen aus dem Kästchen Benachrichtigungstypen filtern.

  5. Klicken Sie auf Änderungen speichern.

Einrichtung für Cluster-Benachrichtigungen prüfen

Im Autopilot-Modus können Sie Clusterbenachrichtigungen so prüfen:

  1. Upgrade der Steuerungsebene starten
  2. Warten Sie, bis GKE Ihre Knoten automatisch auf die neue Version aktualisiert hat. Die Dauer kann je nach den konfigurierten Wartungsfenstern und -ausschlüssen variieren.
  3. Prüfen Sie nach dem Upgrade Ihrer Knoten in GKE Ihr Pub/Sub-Abo.

Im Standardmodus können Sie Clusterbenachrichtigungen so prüfen:

  1. Aktualisieren Sie einen bestimmten Knotenpool auf eine neue Version Wenn Sie die GKE-Version auf den Knoten nicht ändern möchten, können Sie ein Upgrade auf die aktuelle Version auf den Knoten ausführen.

  2. Prüfen Sie nach dem Upgrade Ihrer Knoten in GKE Ihr Pub/Sub-Abo.

Sie können die Einrichtung nur für den Benachrichtigungstyp UpgradeEvent manuell prüfen. Wenn Ihre Filter so konfiguriert sind, dass dieser Typ ignoriert wird, wird keine Meldung angezeigt.

Cluster-Benachrichtigungen deaktivieren

Sie können Clusterbenachrichtigungen mit der gcloud CLI oder der Google Cloud Console deaktivieren.

gcloud

Führen Sie folgenden Befehl aus, um Benachrichtigungen mit der gcloud CLI zu deaktivieren:

gcloud container clusters update CLUSTER_NAME \
  --region=COMPUTE_REGION \
  --notification-config=pubsub=DISABLED

Console

So deaktivieren Sie Benachrichtigungen mit der Google Cloud Console:

  1. Rufen Sie in der Google Cloud Console die Seite Google Kubernetes Engine auf.

    Zur Seite "Google Kubernetes Engine"

  2. Klicken Sie auf den Namen des Clusters, den Sie ändern möchten.

  3. Klicken Sie unter Automatisierung neben Benachrichtigungen auf Benachrichtigungen bearbeiten.

  4. Heben Sie im Dialogfeld Benachrichtigungen bearbeiten die Markierung des Kästchens Benachrichtigungen aktivieren auf.

  5. Klicken Sie auf Änderungen speichern.

Optional können Sie das Pub/Sub-Thema löschen, das Sie für Benachrichtigungen erstellt haben.

Nächste Schritte