Ricevere notifiche del cluster

Autopilot Standard

---

Questa pagina mostra come utilizzare Pub/Sub per ricevere notifiche sui tuoi cluster Google Kubernetes Engine (GKE).

Panoramica

Quando si verificano determinati eventi pertinenti per i tuoi cluster GKE, come importanti upgrade pianificati o bollettini sulla sicurezza disponibili, GKE pubblica notifiche relative a questi eventi come messaggi negli argomenti Pub/Sub che configuri. Puoi ricevere queste notifiche in una sottoscrizione Pub/Sub, integrarle con servizi di terze parti e filtrare in base ai tipi di notifiche che vuoi ricevere.

Per scoprire di più sui vantaggi delle notifiche cluster, sul loro funzionamento e sul motivo per cui il filtro è importante, consulta Notifiche cluster. Puoi configurare le notifiche dei cluster nei cluster standard nuovi ed esistenti e aggiornando i cluster Autopilot esistenti.

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti operazioni:

• Attiva l'API Google Kubernetes Engine.
Attiva l'API Google Kubernetes Engine
• Se vuoi utilizzare Google Cloud CLI per questa attività, installa e poi inizializza gcloud CLI. Se hai già installato gcloud CLI, ottieni la versione più recente eseguendo gcloud components update.
  Nota: per le installazioni esistenti di gcloud CLI, assicurati di impostare le proprietà compute/region e compute/zone. Se imposti le posizioni predefinite, puoi evitare errori in gcloud CLI come il seguente: One of [--zone, --region] must be supplied: Please specify location.

• Crea un argomento Pub/Sub nel tuo progetto.

Attivare le notifiche del cluster in un nuovo cluster

Puoi attivare le notifiche dei cluster GKE su un nuovo cluster standard utilizzando Google Cloud CLI o la console Google Cloud. Per attivare le notifiche sui cluster Autopilot, devi prima creare un cluster Autopilot e poi aggiornarlo in modo che utilizzi le notifiche del cluster.

gcloud

Per attivare le notifiche del cluster su un nuovo cluster, esegui il seguente 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

Sostituisci quanto segue:

• CLUSTER_NAME: il nome del nuovo cluster.
• COMPUTE_REGION: la regione di calcolo per il nuovo cluster. Per i cluster standard zonali, utilizza --zone=COMPUTE_ZONE.
• PROJECT_ID: il tuo ID progetto Google Cloud.
• TOPIC_NAME: il nome dell'argomento Pub/Sub.

• NOTIFICATION_TYPE: un elenco delimitato da barre verticali (|) dei tipi di notifiche che vuoi ricevere. Ad esempio, filter="UpgradeEvent|SecurityBulletinEvent" invia solo notifiche UpgradeEvent e SecurityBulletinEvent, ignorando tutti gli altri tipi.

  Nota: se non specifichi valori per filter, riceverai tutte le notifiche applicabili alla configurazione del cluster.

Console

Per attivare le notifiche del cluster in un nuovo cluster standard:

1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud.

   Vai a Google Kubernetes Engine

2. Fai clic su Crea.

3. Nella finestra di dialogo Crea cluster, accanto a GKE Standard, fai clic su Configura.

4. Nel riquadro di navigazione, fai clic su Automazione nella sezione Cluster.

5. Seleziona la casella di controllo Attiva notifiche.

6. Nell'elenco a discesa, seleziona l'argomento Pub/Sub che hai creato.

7. Per filtrare le notifiche, seleziona la casella di controllo Filtra i tipi di notifica, quindi seleziona i tipi di notifica che vuoi ricevere.

   Nota: se non selezioni i tipi di notifiche da filtrare, riceverai tutte le notifiche applicabili.

8. Continua a configurare il cluster.

9. Fai clic su Crea.

Dopo aver attivato le notifiche, scegli il tipo di abbonamento per il tuo argomento.

Nota: GKE non impone limitazioni su come correlare gli argomenti ai cluster, purché gli argomenti si trovino nello stesso progetto dei cluster. Puoi scegliere di creare un argomento per tutti i cluster o più argomenti per gruppi di cluster.

Attivare le notifiche del cluster in un cluster esistente

Puoi attivare le notifiche del cluster GKE su un cluster esistente utilizzando Google Cloud CLI o la console Google Cloud.

gcloud

Per attivare le notifiche del cluster su un cluster esistente, esegui il seguente 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

Sostituisci quanto segue:

• CLUSTER_NAME: il nome del tuo cluster.
• COMPUTE_REGION: la regione di calcolo per il nuovo cluster. Per i cluster standard zonali, utilizza --zone=COMPUTE_ZONE.
• PROJECT_ID: il tuo ID progetto Google Cloud.
• TOPIC_NAME: il nome dell'argomento Pub/Sub.

• NOTIFICATION_TYPE: un elenco delimitato da barre verticali (|) dei tipi di notifiche che vuoi ricevere. Ad esempio, filter="UpgradeEvent|SecurityBulletinEvent" invia solo notifiche UpgradeEvent e SecurityBulletinEvent, ignorando tutti gli altri tipi.

  Nota: se non specifichi valori per filter, riceverai tutte le notifiche applicabili alla configurazione del cluster.

Console

Per attivare le notifiche del cluster su un cluster esistente, svolgi i seguenti passaggi:

1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud.

   Vai a Google Kubernetes Engine

2. Fai clic sul nome del cluster da modificare.

3. Nella sezione Automazione, accanto a Notifiche, fai clic su Modifica notifiche.

4. Nella finestra di dialogo Modifica notifiche, seleziona la casella di controllo Attiva notifiche.

5. Nell'elenco a discesa, seleziona l'argomento Pub/Sub che hai creato.

6. Per filtrare le notifiche, seleziona la casella di controllo Filtra i tipi di notifica, quindi seleziona i tipi di notifica che vuoi ricevere.

   Nota: se non selezioni i tipi di notifiche da filtrare, riceverai tutte le notifiche applicabili.

7. Fai clic su Salva modifiche.

Dopo aver attivato le notifiche, scegli il tipo di abbonamento per il tuo argomento.

Nota: GKE non impone limitazioni su come correlare gli argomenti ai cluster, purché gli argomenti si trovino nello stesso progetto dei cluster. Puoi scegliere di creare un argomento per tutti i cluster o più argomenti per gruppi di cluster

.

Filtrare le notifiche del cluster

Puoi filtrare le notifiche in base al tipo di notifica per assicurarti di ricevere quelle che ti interessano.

Puoi scegliere di filtrare le notifiche utilizzando i seguenti metodi:

• GKE: specifica i valori per filter nel flag --notification-config, come mostrato negli esempi precedenti per l'attivazione delle notifiche del cluster.
• Pub/Sub: configura l'abbonamento Pub/Sub per filtrare i messaggi quando crei un abbonamento.

Nota: ti consigliamo di applicare i filtri utilizzando GKE. I filtri in GKE ti consentono di modificarli in qualsiasi momento ed eliminano il costo dei messaggi non recapitati associato ai filtri Pub/Sub. Per scoprire di più sulle differenze tra le opzioni di filtro, consulta Filtrare le notifiche.

Modificare i filtri esistenti in GKE

Per modificare i filtri di notifica del cluster GKE esistenti, segui le istruzioni riportate in Attivare le notifiche in un cluster esistente e specifica i nuovi tipi di notifiche da filtrare nel comando gcloud o seleziona i nuovi tipi nella console Google Cloud.

Disattivare i filtri in GKE

Puoi disattivare i filtri delle notifiche di GKE e ricevere tutti i tipi di notifiche applicabili al tuo cluster utilizzando la gcloud CLI o la console Google Cloud.

gcloud

Per disattivare i filtri utilizzando gcloud CLI, esegui il seguente comando:

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

Console

Per disattivare i filtri utilizzando la console Google Cloud, svolgi i seguenti passaggi:

1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud.

   Vai a Google Kubernetes Engine

2. Fai clic sul nome del cluster da modificare.

3. Nella sezione Automazione, accanto a Notifiche, fai clic su Modifica notifiche.

4. Nella finestra di dialogo Modifica notifiche, deseleziona la casella di controllo Filtra i tipi di notifica.

5. Fai clic su Salva modifiche.

Verificare la configurazione delle notifiche del cluster

In modalità Autopilot, puoi verificare le notifiche del cluster nel seguente modo:

1. Avvia un upgrade del piano di controllo.
2. Attendi che GKE esegua automaticamente l'upgrade dei nodi alla nuova versione. Il tempo necessario potrebbe variare in base ai periodi di manutenzione e alle esclusioni configurati.
3. Dopo che GKE ha eseguito l'upgrade dei nodi, controlla l'abbonamento a Pub/Sub.

In modalità Standard, puoi verificare le notifiche del cluster nel seguente modo:

1. Esegui l'upgrade di un pool di nodi specifico a una nuova versione. Se non vuoi modificare la versione GKE sui tuoi nodi, puoi eseguire l'upgrade alla stessa versione attualmente presente sui nodi.

   Attenzione: l'upgrade manuale di un pool di nodi standard ignora i periodi di manutenzione configurati e potrebbe causare interruzioni dei workload in esecuzione.

2. Dopo che GKE ha eseguito l'upgrade dei nodi, controlla l'abbonamento a Pub/Sub.

Puoi verificare manualmente la configurazione solo per il tipo di notifica UpgradeEvent. Se i tuoi filtri sono configurati per ignorare questo tipo, non visualizzerai alcun messaggio.

Disattivare le notifiche del cluster

Puoi disattivare le notifiche del cluster utilizzando gcloud CLI o la console Google Cloud.

gcloud

Per disattivare le notifiche utilizzando gcloud CLI, esegui il seguente comando:

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

Console

Per disattivare le notifiche utilizzando la console Google Cloud, svolgi i seguenti passaggi:

1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud.

   Vai a Google Kubernetes Engine

2. Fai clic sul nome del cluster da modificare.

3. Nella sezione Automazione, accanto a Notifiche, fai clic su Modifica notifiche.

4. Nella finestra di dialogo Modifica notifiche, deseleziona la casella di controllo Attiva notifiche.

5. Fai clic su Salva modifiche.

Se vuoi, elimina l'argomento Pub/Sub che hai creato per le notifiche.

Passaggi successivi

• Scopri di più sulle notifiche del cluster.
• Scopri di più sulla configurazione delle notifiche Pub/Sub.
• Scopri come configurare le notifiche del cluster per i servizi di terze parti.