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.

Antes de comenzar

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

  • Asegúrate de que habilitaste la API de Google Kubernetes Engine.
  • Habilitar la API de Google Kubernetes Engine
  • Asegúrate de que instalaste Google Cloud CLI.
  • Establece la configuración predeterminada de Google Cloud CLI para tu proyecto mediante uno de los siguientes métodos:
    • Usa gcloud init si deseas ver una explicación sobre cómo configurar los valores predeterminados del proyecto.
    • Usa gcloud config para configurar el ID, la zona y la región del proyecto de manera individual.

    gcloud init

    1. Ejecuta gcloud init y sigue las instrucciones:

      gcloud init

      Si usas SSH en un servidor remoto, usa la marca --console-only para evitar que el comando abra un navegador:

      gcloud init --console-only
    2. Sigue las instrucciones para autorizar a la CLI de gcloud a usar tu cuenta de Google Cloud.
    3. Crea una configuración nueva o selecciona una existente.
    4. Elige un proyecto de Google Cloud.
    5. Elige una zona de Compute Engine predeterminada.
    6. Elige una región de Compute Engine predeterminada.

    gcloud config

    1. Establece tu ID del proyecto predeterminado:
      gcloud config set project PROJECT_ID
    2. Configura la región de Compute Engine predeterminada (por ejemplo, us-central1):
      gcloud config set compute/region COMPUTE_REGION
    3. Configura la zona de Compute Engine predeterminada (por ejemplo, us-central1-c):
      gcloud config set compute/zone COMPUTE_ZONE
    4. Actualiza gcloud a la versión más reciente:
      gcloud components update

    Cuando configuras las ubicaciones predeterminadas, puedes evitar errores en la CLI de gcloud como el siguiente: One of [--zone, --region] must be supplied: Please specify location.

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 Google Cloud Console.

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 Cloud Console: Ir a Google Kubernetes Engine 1. Haga clic en **Crear**.
  1. En el cuadro de diálogo Crear clúster, junto a GKE Standard, haz clic en Configurar.
  2. En el panel de navegación, en la sección Clúster, haz clic en Automatización.
  3. Selecciona la casilla de verificación Enable notifications.
  4. En la lista desplegable, selecciona el tema de Pub/Sub que creaste.
  5. Para filtrar las notificaciones, selecciona la casilla de verificación Filter notification types y, luego, selecciona los tipos de notificaciones que deseas recibir.

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

  7. 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 la CLI de Google Cloud o Cloud Console.

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 Cloud Console:

    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 clúster de GKE existentes, sigue las instrucciones en Habilita notificaciones en un clúster existente y especifica los tipos de notificaciones nuevos que se deben filtrar en el comando gcloud, o bien selecciona los tipos nuevos en Cloud Console.

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 Cloud Console.

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 Cloud Console, sigue estos pasos:

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

    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 Cloud Console. 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 Cloud Console.

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 Cloud Console, realiza lo siguiente:

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

    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?