Receba notificações de clusters através do Pub/Sub

Esta página mostra-lhe como usar o Pub/Sub para receber notificações sobre os seus clusters do Google Kubernetes Engine (GKE).

Por predefinição, o GKE encaminha estas notificações para o Cloud Logging. Pode usar todas as capacidades do Cloud Logging, incluindo consultar e ver registos, e configurar políticas de alerta baseadas em registos. Para encontrar estes registos no Cloud Logging, consulte o artigo Ver notificações de clusters no Cloud Logging.

Vista geral

Quando ocorrem determinados eventos relevantes para os seus clusters do GKE, como atualizações agendadas importantes ou boletins de segurança disponíveis, o GKE publica notificações sobre esses eventos como mensagens em tópicos do Pub/Sub que configura. Pode receber estas notificações numa subscrição do Pub/Sub, integrar com serviços de terceiros e filtrar os tipos de notificações que quer receber.

Para saber mais sobre as vantagens das notificações agrupadas, como funcionam as notificações e por que motivo a filtragem é importante, consulte o artigo Notificações agrupadas. Pode configurar notificações de clusters em clusters padrão novos e existentes, e atualizando clusters do Autopilot existentes.

Antes de começar

Antes de começar, certifique-se de que realizou as seguintes tarefas:

• Ative a API Google Kubernetes Engine.
Ative a API Google Kubernetes Engine
• Se quiser usar a CLI gcloud para esta tarefa, instale-a e, em seguida, inicialize-a. Se instalou anteriormente a CLI gcloud, execute gcloud components update para obter a versão mais recente.

• Crie um tópico do Pub/Sub. Pode criar um tópico no projeto do cluster ou num projeto diferente na sua organização.

Autorizações para notificações de clusters entre projetos

Para usar um tópico Pub/Sub de um projeto diferente do seu cluster, conceda as seguintes funções do projeto do tópico à conta de serviço no projeto do cluster:service-PROJECT_NUMBER@container-engine-robot.s3ns.iam.gserviceaccount.com

• Visualizador do Pub/Sub
• Publicador do Pub/Sub

Ative as notificações de clusters num novo cluster

Pode ativar as notificações de clusters do GKE num novo cluster padrão através da CLI Google Cloud ou da Trusted Cloud consola. Para ativar a notificação em clusters do Autopilot, primeiro tem de criar um cluster do Autopilot e, em seguida, atualizar o cluster para usar notificações de cluster.

Pode optar por criar um tópico para todos os clusters ou criar vários tópicos para grupos de clusters.

gcloud container clusters create CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION \
    --notification-config=pubsub=ENABLED,pubsub-topic=projects/TOPIC_PROJECT_ID/topics/TOPIC_NAME,filter=NOTIFICATION_TYPE

Depois de ativar as notificações, escolha o tipo de subscrição para o seu tópico.

Ative as notificações de clusters num cluster existente

Pode ativar as notificações de clusters do GKE num cluster existente através da CLI Google Cloud ou da Trusted Cloud consola.

Pode optar por criar um tópico para todos os clusters ou criar vários tópicos para grupos de clusters.

gcloud container clusters update CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION \
    --notification-config=pubsub=ENABLED,pubsub-topic=projects/TOPIC_PROJECT_ID/topics/TOPIC_NAME,filter=NOTIFICATION_TYPE

Depois de ativar as notificações, escolha o tipo de subscrição para o seu tópico.

Filtre notificações de clusters

Pode filtrar as notificações por tipo de notificação para garantir que recebe as notificações que quer.

Pode optar por filtrar as notificações através dos seguintes métodos:

• GKE: especifique valores para filter no comando --notification-config, conforme mostrado nos exemplos anteriores para ativar as notificações de cluster.
• Pub/Sub: configure a sua subscrição do Pub/Sub para filtrar mensagens quando cria uma subscrição.

Modifique filtros existentes no GKE

Para modificar os filtros de notificação do cluster do GKE existente, siga as instruções em Ative as notificações num cluster existente e especifique os novos tipos de notificação a filtrar no comando gcloud ou selecione os novos tipos na consola Trusted Cloud .

Desative filtros no GKE

Pode desativar os filtros de notificação do GKE e receber todos os tipos de notificação aplicáveis ao seu cluster através da CLI gcloud ou da Trusted Cloud consola.

gcloud container clusters update CLUSTER_NAME \
  --location=CONTROL_PLANE_LOCATION \
  --notification-config=pubsub=ENABLED,pubsub-topic=projects/TOPIC_PROJECT_ID/topics/TOPIC_NAME

Valide a configuração das notificações de clusters

No modo de piloto automático, pode validar as notificações de clusters da seguinte forma:

1. Inicie uma atualização do plano de controlo.
2. Aguarde que o GKE atualize automaticamente os seus nós para a nova versão. O tempo necessário pode variar com base nas janelas de manutenção configuradas e nas exclusões.
3. Depois de o GKE atualizar os seus nós, verifique a sua subscrição do Pub/Sub.

No modo padrão, pode validar as notificações de clusters da seguinte forma:

1. Atualize um node pool específico para uma nova versão. Se não quiser alterar a versão do GKE nos seus nós, pode atualizar para a mesma versão atualmente nos nós.

2. Depois de o GKE atualizar os seus nós, verifique a sua subscrição do Pub/Sub.

Só pode validar manualmente a configuração para o tipo de notificação UpgradeEvent. Se os seus filtros estiverem configurados para ignorar este tipo, não vê uma mensagem.

Desative as notificações de clusters

Pode desativar as notificações de clusters através da CLI gcloud ou da Trusted Cloud consola.

gcloud container clusters update CLUSTER_NAME \
  --location=CONTROL_PLANE_LOCATION \
  --notification-config=pubsub=DISABLED

Opcionalmente, elimine o tópico do Pub/Sub que criou para as notificações.

O que se segue?

• Saiba mais acerca das notificações agrupadas.
• Saiba como configurar notificações do Pub/Sub.
• Saiba como configurar notificações de clusters para serviços de terceiros.