Recevoir des notifications de cluster

Cette page vous explique comment utiliser Pub/Sub pour recevoir des notifications sur vos clusters Google Kubernetes Engine (GKE).

Aperçu

Lorsque certains événements se rapportent à vos clusters GKE, tels que des mises à niveau programmées importantes ou des bulletins de sécurité disponibles, GKE publie des notifications sur ces événements sous forme de messages dans les sujets Pub/Sub que vous configurez. Vous pouvez recevoir ces notifications sur un abonnement Pub/Sub, intégrer des services tiers et filtrer les types de notifications que vous souhaitez recevoir.

Pour en savoir plus sur les avantages des notifications de cluster, le fonctionnement des notifications et l'importance du filtrage, consultez la page Notifications de cluster.

Avant de commencer

Avant de commencer, effectuez les tâches suivantes :

  • Assurez-vous d'avoir activé l'API Google Kubernetes Engine.
  • Activer l'API Google Kubernetes Engine
  • Assurez-vous d'avoir installé le SDK Cloud.
  • Configurez les paramètres de l'outil de ligne de commande gcloud par défaut pour votre projet en utilisant l'une des méthodes suivantes :
    • Utilisez gcloud init si vous souhaitez suivre les étapes de définition des paramètres par défaut du projet.
    • Utilisez gcloud config pour définir individuellement l'ID, la zone et la région de votre projet.

    gcloud init

    1. Exécutez gcloud init et suivez les instructions :

      gcloud init

      Si vous utilisez SSH sur un serveur distant, utilisez l'option --console-only pour empêcher la commande d'ouvrir un navigateur :

      gcloud init --console-only
    2. Suivez les instructions pour autoriser l'outil gcloud à utiliser votre compte Google Cloud.
    3. Créez ou sélectionnez une configuration.
    4. Choisissez un projet Google Cloud.
    5. Choisissez une zone Compute Engine par défaut.
    6. Choisissez une région Compute Engine par défaut.

    gcloud config

    1. Définissez votre ID de projet par défaut :
      gcloud config set project PROJECT_ID
    2. Définissez votre région Compute Engine par défaut (par exemple, us-central1) :
      gcloud config set compute/region COMPUTE_REGION
    3. Définissez votre zone Compute Engine par défaut (par exemple, us-central1-c) :
      gcloud config set compute/zone COMPUTE_ZONE
    4. Mettez à jour gcloud vers la dernière version :
      gcloud components update

    En définissant des emplacements par défaut, vous pouvez éviter les erreurs dans l'outil gcloud, telles que les suivantes : One of [--zone, --region] must be supplied: Please specify location.

Activer les notifications de cluster sur un nouveau cluster

Vous pouvez activer les notifications de cluster GKE sur un nouveau cluster à l'aide de l'outil de ligne de commande gcloud ou de Google Cloud Console.

gcloud

Pour activer les notifications sur un nouveau cluster, exécutez la commande suivante :

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

Remplacez les éléments suivants :

  • CLUSTER_NAME : nom de votre nouveau cluster
  • COMPUTE_REGION : région de calcul de votre nouveau cluster. Pour les clusters zonaux, utilisez --zone=COMPUTE_ZONE.
  • PROJECT_ID : ID de votre projet Google Cloud.
  • TOPIC_NAME : nom de votre sujet Pub/Sub.
  • NOTIFICATION_TYPE : liste délimitée par des barres verticales (|) des types de notifications que vous souhaitez recevoir. Par exemple, filter="UpgradeEvent|SecurityBulletinEvent" n'envoie que les notifications UpgradeEvent et SecurityBulletinEvent, en ignorant tous les autres types.

Console

Pour activer les notifications de cluster sur un nouveau cluster, procédez comme suit :

1. Accédez à la page **Google Kubernetes Engine** dans Cloud Console. Accéder à Google Kubernetes Engine 1. Cliquez sur **Créer**.
  1. Dans la boîte de dialogue Créer un cluster, à côté de GKE standard, cliquez sur Configurer.
  2. Dans la section Cluster du volet de navigation, cliquez sur Automatisation.
  3. Cochez la case Activer les notifications.
  4. Dans la liste déroulante, sélectionnez le sujet Pub/Sub que vous avez créé.
  5. Pour filtrer les notifications, cochez la case Filtrer les types de notifications, puis sélectionnez les types de notifications que vous souhaitez recevoir.

  6. Continuez à configurer le cluster selon vos besoins.

  7. Cliquez sur Create (Créer).

Après avoir activé les notifications, créez un abonnement Pub/Sub pour votre sujet.

Activer les notifications de cluster sur un cluster existant

Vous pouvez activer les notifications de cluster GKE sur un cluster existant à l'aide de l'outil de ligne de commande gcloud ou de Cloud Console.

gcloud

Pour activer les notifications de cluster sur un cluster existant, exécutez la commande suivante :

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

Remplacez les éléments suivants :

  • CLUSTER_NAME : nom du cluster
  • COMPUTE_REGION : région de calcul de votre nouveau cluster. Pour les clusters zonaux, utilisez --zone=COMPUTE_ZONE.
  • PROJECT_ID : ID de votre projet Google Cloud.
  • TOPIC_NAME : nom de votre sujet Pub/Sub.
  • NOTIFICATION_TYPE : liste délimitée par des barres verticales (|) des types de notifications que vous souhaitez recevoir. Par exemple, filter="UpgradeEvent|SecurityBulletinEvent" n'envoie que les notifications UpgradeEvent et SecurityBulletinEvent, en ignorant tous les autres types.

Console

Pour activer les notifications de cluster sur un cluster existant, procédez comme suit :

  1. Accédez à la page Google Kubernetes Engine dans Cloud Console.

    Accéder à Google Kubernetes Engine

  2. Cliquez sur le nom du cluster que vous souhaitez modifier.

  3. Dans la section Automatisation, à côté de Notifications, cliquez sur Modifier les notifications.

  4. Dans la boîte de dialogue Modifier les notifications, cochez la case Activer les notifications.

  5. Dans la liste déroulante, sélectionnez le sujet Pub/Sub que vous avez créé.

  6. Pour filtrer les notifications, cochez la case Filtrer les types de notifications, puis sélectionnez les types de notifications que vous souhaitez recevoir.

  7. Cliquez sur Enregistrer les modifications.

Après avoir activé les notifications, créez un abonnement Pub/Sub pour votre sujet.

Filtrer les notifications de cluster

Vous pouvez filtrer les notifications par type de notification pour vous assurer que vous recevez les notifications souhaitées.

Vous pouvez choisir de filtrer les notifications en utilisant les méthodes suivantes :

  • GKE : spécifiez des valeurs pour filter dans l'option --notification-config, comme indiqué dans les exemples précédents pour l'activation des notifications de cluster.
  • Pub/Sub : configurez votre abonnement Pub/Sub pour filtrer les messages lorsque vous créez un abonnement.

Modifier les filtres existants dans GKE

Pour modifier les filtres de notifications de cluster GKE existants, suivez les instructions de la section Activer les notifications sur un cluster existant et spécifiez les nouveaux types de notifications à filtrer dans la commande gcloud, ou sélectionnez les nouveaux types dans Cloud Console.

Désactiver les filtres dans GKE

Vous pouvez désactiver vos filtres de notification GKE et recevoir tous les types de notifications applicables à votre cluster à l'aide de l'outil gcloud ou de Cloud Console.

gcloud

Pour désactiver les filtres à l'aide de l'outil gcloud, exécutez la commande suivante :

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

Console

Pour désactiver les filtres à l'aide de Cloud Console, procédez comme suit :

  1. Accédez à la page Google Kubernetes Engine dans Cloud Console.

    Accéder à Google Kubernetes Engine

  2. Cliquez sur le nom du cluster que vous souhaitez modifier.

  3. Dans la section Automatisation, à côté de Notifications, cliquez sur Modifier les notifications.

  4. Dans la boîte de dialogue Modifier les notifications, décochez la case Filtrer les types de notifications.

  5. Cliquez sur Enregistrer les modifications.

Vérifier la configuration des notifications de cluster

Pour vérifier que les notifications sont correctement configurées pour votre cluster, vous pouvez lancer une mise à niveau du pool de nœuds pour voir si un message UpgradeEvent est envoyé. Vous ne pouvez vérifier manuellement la configuration que pour le type de notification UpgradeEvent. Si vos filtres sont configurés pour ignorer ce type, aucun message ne s'affiche.

Vous pouvez mettre à niveau manuellement un pool de nœuds spécifique à l'aide de l'outil gcloud ou de Cloud Console. Pour obtenir des instructions, consultez la page Mettre à jour manuellement un cluster ou un pool de nœuds. Si vous ne souhaitez pas modifier la version de GKE sur vos nœuds, vous pouvez effectuer une mise à niveau vers la même version actuellement installée sur les nœuds.

Une fois la mise à niveau lancée, vérifiez que votre abonnement Pub/Sub contient bien un message de notification.

Désactiver les notifications de cluster

Vous pouvez désactiver les notifications de cluster à l'aide de l'outil gcloud ou de Cloud Console.

gcloud

Pour désactiver les notifications à l'aide de l'outil gcloud, exécutez la commande suivante :

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

Console

Pour désactiver les notifications à l'aide de Cloud Console, procédez comme suit :

  1. Accédez à la page Google Kubernetes Engine dans Cloud Console.

    Accéder à Google Kubernetes Engine

  2. Cliquez sur le nom du cluster que vous souhaitez modifier.

  3. Dans la section Automatisation, à côté de Notifications, cliquez sur Modifier les notifications.

  4. Dans la boîte de dialogue Modifier les notifications, décochez la case Activer les notifications.

  5. Cliquez sur Enregistrer les modifications.

Si vous le souhaitez, supprimez le sujet Pub/Sub que vous avez créé pour les notifications.

Étape suivante