Recibe notificaciones de clúster


En esta página, se muestra cómo usar Pub/Sub para recibir notificaciones sobre los clústeres de Google Kubernetes Engine (GKE).

Descripción general

Cuando ocurren ciertos eventos relevantes para los clústeres de GKE, como actualizaciones programadas importantes o boletines de seguridad disponibles, GKE publica notificaciones sobre esos eventos como mensajes en temas de Pub/Sub que configuras. Puedes recibir estas notificaciones en una suscripción de Pub/Sub, integrarlas a servicios de terceros y filtrar por los tipos de notificaciones que deseas recibir.

Para obtener más información sobre los beneficios de las notificaciones de clúster, cómo funcionan las notificaciones y por qué es importante el filtrado, consulta Notificaciones de clúster. Puedes configurar las notificaciones de clústeres en clústeres estándar nuevos y existentes, y actualizar los clústeres de Autopilot existentes.

Antes de comenzar

Antes de comenzar, asegúrate de haber realizado las siguientes tareas:

  • Habilita la API de Google Kubernetes Engine.
  • Habilitar la API de Google Kubernetes Engine
  • Si deseas usar Google Cloud CLI para esta tarea, instala y, luego, inicializa gcloud CLI. Si ya instalaste gcloud CLI, ejecuta gcloud components update para obtener la versión más reciente.

Habilita las notificaciones de clúster en un clúster nuevo

Puedes habilitar las notificaciones de clústeres de GKE en un clúster Estándar nuevo mediante la CLI de Google Cloud o la consola de Google Cloud. Para habilitar las notificaciones en los clústeres de Autopilot, primero debes crear un clúster de Autopilot y, luego, actualizar el clúster a fin de usar las notificaciones de clústeres.

gcloud

Para habilitar las notificaciones de clúster en un clúster nuevo, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

  • CLUSTER_NAME: Es el nombre del clúster nuevo.
  • COMPUTE_REGION: Es la región de procesamiento del clúster nuevo. Para los clústeres de Standard zonales, usa --zone=COMPUTE_ZONE.
  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud.
  • TOPIC_NAME: Es el nombre del tema de Pub/Sub.
  • NOTIFICATION_TYPE: Una lista delimitada por canalizaciones (|) de los tipos de notificaciones que deseas recibir. Por ejemplo, filter="UpgradeEvent|SecurityBulletinEvent" solo envía notificaciones de UpgradeEvent y SecurityBulletinEvent e ignora todos los demás tipos.

Console

Para habilitar las notificaciones de clúster en un clúster Estándar nuevo, realiza las siguientes acciones:

  1. Ve a la página de Google Kubernetes Engine en la consola de Google Cloud.

    Ir a Google Kubernetes Engine

  2. Haz clic en Crear.

  3. En el cuadro de diálogo Crear clúster, junto a GKE Standard, haz clic en Configurar.

  4. En el panel de navegación, en la sección Clúster, haz clic en Automatización.

  5. Selecciona la casilla de verificación Enable notifications.

  6. En la lista desplegable, selecciona el tema de Pub/Sub que creaste.

  7. Para filtrar las notificaciones, selecciona la casilla de verificación Filter notification types y, luego, selecciona los tipos de notificaciones que deseas recibir.

  8. Continúa con la configuración del clúster como desees.

  9. Haz clic en Crear.

Después de habilitar las notificaciones, crea una suscripción a Pub/Sub para el tema.

Habilita las notificaciones de clúster en un clúster existente

Puedes habilitar las notificaciones de clústeres de GKE en un clúster existente con Google Cloud CLI o la consola de Google Cloud.

gcloud

Para habilitar las notificaciones de clúster en un clúster existente, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

  • CLUSTER_NAME: El nombre de tu clúster.
  • COMPUTE_REGION: Es la región de procesamiento del clúster nuevo. Para los clústeres de Standard zonales, usa --zone=COMPUTE_ZONE.
  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud.
  • TOPIC_NAME: Es el nombre del tema de Pub/Sub.
  • NOTIFICATION_TYPE: Una lista delimitada por canalizaciones (|) de los tipos de notificaciones que deseas recibir. Por ejemplo, filter="UpgradeEvent|SecurityBulletinEvent" solo envía notificaciones de UpgradeEvent y SecurityBulletinEvent e ignora todos los demás tipos.

Console

Para habilitar las notificaciones de clúster en un clúster existente, haz lo siguiente:

  1. Ve a la página de Google Kubernetes Engine en la consola de Google Cloud.

    Ir a Google Kubernetes Engine

  2. Haz clic en el nombre del clúster que deseas modificar.

  3. En la sección Automatización, junto a Notificaciones, haz clic en Edit notifications.

  4. En el cuadro de diálogo Edit notifications, selecciona la casilla de verificación Enable notifications.

  5. En la lista desplegable, selecciona el tema de Pub/Sub que creaste.

  6. Para filtrar las notificaciones, selecciona la casilla de verificación Filter notification types y, luego, selecciona los tipos de notificaciones que deseas recibir.

  7. Haz clic en Guardar cambios.

Después de habilitar las notificaciones, crea una suscripción a Pub/Sub para el tema.

Filtra notificaciones de clúster

Puedes filtrar las notificaciones por tipo de notificación para asegurarte de que recibas las notificaciones que deseas.

Puedes filtrar las notificaciones con los siguientes métodos:

  • GKE: Especifica los valores de filter en la marca --notification-config, como se muestra en los ejemplos anteriores para habilitar las notificaciones de clúster.
  • Pub/Sub: Configura tu suscripción a Pub/Sub para filtrar mensajes cuando crees una suscripción.

Modifica filtros existentes en GKE

Para modificar los filtros de notificación de tu clúster de GKE existente, sigue las instrucciones en Habilita notificaciones en un clúster existente y especifica los nuevos tipos de notificaciones que se deben filtrar en el comando gcloud, o bien selecciona los tipos nuevos en la consola de Google Cloud.

Inhabilita los filtros en GKE

Puedes inhabilitar los filtros de notificación de GKE y recibir todos los tipos de notificaciones aplicables a tu clúster mediante la CLI de gcloud o la consola de Google Cloud.

gcloud

Para inhabilitar los filtros con la CLI de gcloud, ejecuta el siguiente comando:

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

Console

Para inhabilitar los filtros con la consola de Google Cloud, sigue estos pasos:

  1. Ve a la página de Google Kubernetes Engine en la consola de Google Cloud.

    Ir a Google Kubernetes Engine

  2. Haz clic en el nombre del clúster que deseas modificar.

  3. En la sección Automatización, junto a Notificaciones, haz clic en Edit notifications.

  4. En el cuadro de diálogo Edit notifications, desmarca la casilla de verificación Filter notification types.

  5. Haz clic en Guardar cambios.

Verifica la configuración de las notificaciones de clúster

En el modo Autopilot, puedes verificar las notificaciones del clúster de la siguiente manera:

  1. Inicia una actualización del plano de control.
  2. Espera a que GKE actualice de manera automática tus nodos a la versión nueva. El tiempo puede variar según los períodos de mantenimiento y las exclusiones configurados.
  3. Después de que GKE actualice los nodos, verifica tu suscripción a Pub/Sub.

En el modo Standard, puedes verificar las notificaciones del clúster de la siguiente manera:

  1. Actualiza un grupo de nodos específico a una versión nueva. Si no deseas cambiar la versión de GKE en tus nodos, puedes actualizar a la misma versión actual de los nodos.

  2. Después de que GKE actualice los nodos, verifica tu suscripción a Pub/Sub.

Solo puedes verificar manualmente la configuración del tipo de notificación UpgradeEvent. Si tus filtros están configurados para ignorar este tipo, no verás un mensaje.

Inhabilita las notificaciones de clúster

Puedes inhabilitar las notificaciones del clúster con la CLI de gcloud o la consola de Google Cloud.

gcloud

Para inhabilitar las notificaciones con la CLI de gcloud, ejecuta el siguiente comando:

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

Console

Para inhabilitar las notificaciones con la consola de Google Cloud, realiza lo siguiente:

  1. Ve a la página de Google Kubernetes Engine en la consola de Google Cloud.

    Ir a Google Kubernetes Engine

  2. Haz clic en el nombre del clúster que deseas modificar.

  3. En la sección Automatización, junto a Notificaciones, haz clic en Edit notifications.

  4. En el cuadro de diálogo Edit notifications, desmarca la casilla de verificación Enable notifications.

  5. Haz clic en Guardar cambios.

De forma opcional, borra el tema de Pub/Sub que creaste para las notificaciones.

¿Qué sigue?