Recevoir des notifications de cluster

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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

Aperçu

En cas d'événements se rapportant à vos clusters GKE, tels que des mises à niveau importantes planifiées ou la disponibilité de bulletins de sécurité, 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, les 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 de ces notifications et l'importance du filtrage, consultez la page Notifications de cluster.

Avant de commencer

Avant de commencer, effectuez les tâches suivantes :

  • Activez l'API Google Kubernetes Engine.
  • Activer l'API Google Kubernetes Engine
  • Si vous souhaitez utiliser Google Cloud CLI pour cette tâche, installez puis initialisez gcloud CLI.

Activer les notifications de cluster sur un nouveau cluster

Vous pouvez activer les notifications de cluster GKE sur un nouveau cluster à l'aide de Google Cloud CLI ou de la console Google Cloud.

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 (|) qui détaille les types de notifications que vous souhaitez recevoir. Par exemple, filter="UpgradeEvent|SecurityBulletinEvent" ne va envoyer que des 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 Google Cloud Console.

    Accéder à Google Kubernetes Engine

  2. Cliquez sur Créer.

  3. Dans la boîte de dialogue Créer un cluster, en regard de GKE Standard, cliquez sur Configurer.

  4. Dans la section Cluster du volet de navigation, cliquez sur Automatisation.

  5. Cochez la case Activer les notifications.

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

  7. Pour filtrer les notifications, cochez la case Filtrer selon le type de notification, puis sélectionnez les types de notifications que vous souhaitez recevoir.

  8. Continuez à configurer le cluster selon vos besoins.

  9. 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 Google Cloud CLI ou de la console Google Cloud.

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 (|) qui détaille les types de notifications que vous souhaitez recevoir. Par exemple, filter="UpgradeEvent|SecurityBulletinEvent" ne va envoyer que des 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 Google Cloud Console.

    Accéder à Google Kubernetes Engine

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

  3. Dans la section Automatisation, en regard 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 selon le type de notification, 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 la console Google Cloud.

Désactiver les filtres dans GKE

Vous pouvez désactiver vos filtres de notifications GKE et recevoir tous les types de notifications applicables à votre cluster en utilisant gcloud CLI ou la console Google Cloud.

gcloud

Pour désactiver les filtres en utilisant gcloud CLI, 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 la console Google Cloud, procédez comme suit :

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

    Accéder à Google Kubernetes Engine

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

  3. Dans la section Automatisation, en regard de Notifications, cliquez sur Modifier les notifications.

  4. Dans la boîte de dialogue Modifier les notifications, décochez la case Filtrer selon le type de notification.

  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 va s'afficher.

Vous pouvez mettre à jour manuellement un pool de nœuds spécifique en utilisant gcloud CLI ou la console Google Cloud. 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 en utilisant gcloud CLI ou la console Google Cloud.

gcloud

Pour désactiver les notifications en utilisant gcloud CLI, 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 la console Google Cloud, procédez comme suit :

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

    Accéder à Google Kubernetes Engine

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

  3. Dans la section Automatisation, en regard 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