Recevoir des notifications de cluster

Autopilot Standard

---

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

Présentation

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. Vous pouvez configurer les notifications de cluster dans des clusters standards nouveaux et existants, ainsi qu'en mettant à jour des clusters Autopilot existants.

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. Si vous avez déjà installé gcloud CLI, assurez-vous de disposer de la dernière version en exécutant la commande gcloud components update.
  Remarque : Pour les installations de gcloud CLI existantes, veillez à définir les propriétés compute/region et compute/zone. En définissant des emplacements par défaut, vous pouvez éviter les erreurs gcloud CLI telles que celle-ci : One of [--zone, --region] must be supplied: Please specify location.

• Créez un sujet Pub/Sub au sein de votre projet.

Activer les notifications de cluster sur un nouveau cluster

Vous pouvez activer les notifications de cluster GKE sur un nouveau cluster standard à l'aide de Google Cloud CLI ou de la console Google Cloud. Pour activer les notifications sur des clusters Autopilot, vous devez d'abord créer un cluster Autopilot, puis le mettre à jour pour utiliser les notifications de cluster.

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 standards, 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.

  Remarque : Si vous ne spécifiez pas de valeurs pour filter, vous recevrez toutes les notifications applicables à la configuration de votre cluster.

Console

Pour activer les notifications de cluster sur un nouveau cluster standard, 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.

   Remarque : Si vous ne sélectionnez pas de types de notifications à filtrer, vous recevrez toutes les notifications applicables.

8. Continuez à configurer le cluster.

9. Cliquez sur Créer.

Après avoir activé les notifications, choisissez le type d'abonnement pour votre thème.

Remarque : GKE n'impose aucune restriction sur la manière dont vous associez des sujets à des clusters, tant que ces sujets se trouvent dans le même projet que les clusters. Vous pouvez choisir de créer un sujet pour l'ensemble des clusters ou de créer plusieurs sujets, chacun étant associé à un groupe de clusters.

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 standards, 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.

  Remarque : Si vous ne spécifiez pas de valeurs pour filter, vous recevrez toutes les notifications applicables à la configuration de votre cluster.

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.

   Remarque : Si vous ne sélectionnez pas de types de notifications à filtrer, vous recevrez toutes les notifications applicables.

7. Cliquez sur Enregistrer les modifications.

Après avoir activé les notifications, choisissez le type d'abonnement pour votre thème.

Remarque : GKE n'impose aucune restriction sur la manière dont vous associez des sujets à des clusters, tant que ces sujets se trouvent dans le même projet que les clusters. Vous pouvez choisir de créer un sujet pour l'ensemble des clusters ou de créer plusieurs sujets, chacun étant associé à un groupe de clusters.

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.

Remarque : Nous vous recommandons de procéder au filtrage à l'aide de GKE. Le filtrage dans GKE vous permet de modifier les filtres à tout moment et d'éliminer les coûts liés aux messages non distribués, qui sont associés aux filtres Pub/Sub. Pour en savoir plus sur les différences entre les options de filtrage, consultez la page Filtrer les notifications.

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

En mode Autopilot, vous pouvez vérifier les notifications de cluster comme suit :

1. Démarrez une mise à niveau du plan de contrôle.
2. Attendez que GKE mette automatiquement à niveau vos nœuds vers la nouvelle version. Le temps nécessaire peut varier en fonction des exclusions et des intervalles de maintenance configurés.
3. Une fois que GKE a mis à niveau vos nœuds, vérifiez votre abonnement Pub/Sub.

En mode Standard, vous pouvez vérifier les notifications de cluster comme suit :

1. Mettez à niveau un pool de nœuds spécifique vers une nouvelle version. 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.

   Attention : La mise à niveau manuelle d'un pool de nœuds standard ignore vos intervalles de maintenance configurés et peut entraîner des interruptions de l'exécution des charges de travail.

2. Une fois que GKE a mis à niveau vos nœuds, vérifiez votre abonnement Pub/Sub.

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.

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

• Obtenez davantage d'informations sur les notifications de cluster.
• Découvrez comment configurer des notifications Pub/Sub.
• Découvrez comment configurer des notifications de cluster pour des services tiers.