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.
- Crea un tema de Pub/Sub en tu proyecto.
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 deUpgradeEvent
ySecurityBulletinEvent
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:
Ve a la página de Google Kubernetes Engine en la consola de Google Cloud.
Haz clic en add_box Crear.
En el cuadro de diálogo Crear clúster, junto a GKE Standard, haz clic en Configurar.
En el panel de navegación, en la sección Clúster, haz clic en Automatización.
Selecciona la casilla de verificación Enable notifications.
En la lista desplegable, selecciona el tema de Pub/Sub que creaste.
Para filtrar las notificaciones, selecciona la casilla de verificación Filter notification types y, luego, selecciona los tipos de notificaciones que deseas recibir.
Continúa con la configuración del clúster como desees.
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 deUpgradeEvent
ySecurityBulletinEvent
e ignora todos los demás tipos.
Console
Para habilitar las notificaciones de clúster en un clúster existente, haz lo siguiente:
Ve a la página de Google Kubernetes Engine en la consola de Google Cloud.
Haz clic en el nombre del clúster que deseas modificar.
En la sección Automatización, junto a Notificaciones, haz clic en
Edit notifications.En el cuadro de diálogo Edit notifications, selecciona la casilla de verificación Enable notifications.
En la lista desplegable, selecciona el tema de Pub/Sub que creaste.
Para filtrar las notificaciones, selecciona la casilla de verificación Filter notification types y, luego, selecciona los tipos de notificaciones que deseas recibir.
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:
Ve a la página de Google Kubernetes Engine en la consola de Google Cloud.
Haz clic en el nombre del clúster que deseas modificar.
En la sección Automatización, junto a Notificaciones, haz clic en
Edit notifications.En el cuadro de diálogo Edit notifications, desmarca la casilla de verificación Filter notification types.
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:
- Inicia una actualización del plano de control.
- 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.
- 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:
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.
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:
Ve a la página de Google Kubernetes Engine en la consola de Google Cloud.
Haz clic en el nombre del clúster que deseas modificar.
En la sección Automatización, junto a Notificaciones, haz clic en
Edit notifications.En el cuadro de diálogo Edit notifications, desmarca la casilla de verificación Enable notifications.
Haz clic en Guardar cambios.
De forma opcional, borra el tema de Pub/Sub que creaste para las notificaciones.
¿Qué sigue?
- Obtén más información sobre las notificaciones de clúster.
- Obtén más información para configurar las notificaciones de Pub/Sub.
- Obtén más información sobre cómo configurar las notificaciones de clúster para servicios de terceros.