Recibe notificaciones de clúster

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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.

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 la CLI de gcloud.

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

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

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 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 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. Haga 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 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

Si quieres verificar que las notificaciones estén configuradas de forma correcta para tu clúster, puedes iniciar una actualización del grupo de nodos a fin de ver si se envía un mensaje UpgradeEvent. 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.

Puedes actualizar de forma manual un grupo de nodos específico con la CLI de gcloud o la consola de Google Cloud. Para obtener instrucciones, consulta Actualiza un clúster o grupo de nodos de forma manual. Si no deseas cambiar la versión de GKE en tus nodos, puedes actualizar a la misma versión actual de los nodos.

Después de iniciar la actualización, verifica tu suscripción a Pub/Sub para ver un mensaje de notificación.

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?