Ricevi notifiche sui cluster

Autopilot Standard

---

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

Panoramica

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

Per saperne di più sui vantaggi delle notifiche dei cluster, sul funzionamento delle notifiche e sull'importanza dei filtri, consulta Notifiche dei 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 attività:

• Abilita l'API Google Kubernetes Engine.
Abilita l'API Google Kubernetes Engine
• Se vuoi utilizzare Google Cloud CLI per questa attività, installa e initialize gcloud CLI. Se hai già installato gcloud CLI, scarica la versione più recente eseguendo gcloud components update.
  Nota: per le installazioni esistenti dell'interfaccia a riga di comando gcloud, assicurati di impostare le proprietà compute/region e compute/zone. Impostando le località predefinite, puoi evitare errori nellgcloud CLI come segue: One of [--zone, --region] must be supplied: Please specify location.

• Crea un argomento Pub/Sub nel progetto.

Abilita le notifiche per un nuovo cluster

Puoi abilitare le notifiche sui cluster GKE su un nuovo cluster Standard utilizzando Google Cloud CLI o la console Google Cloud. Per abilitare le notifiche sui cluster Autopilot, devi prima creare un cluster Autopilot e poi aggiornare il cluster per utilizzare le notifiche del cluster.

gcloud

Per abilitare le notifiche in un nuovo cluster, esegui questo 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 computing per il nuovo cluster. Per i cluster standard di zona, utilizza --zone=COMPUTE_ZONE.
• PROJECT_ID: l'ID del tuo progetto Google Cloud.
• TOPIC_NAME: il nome dell'argomento Pub/Sub.

• NOTIFICATION_TYPE: un elenco delimitato da barre verticali (|) dei tipi di notifica 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 tuo cluster.

Console

Per abilitare le notifiche in un nuovo cluster Standard, esegui queste operazioni:

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, nella sezione Cluster, fai clic su Automazione.

5. Seleziona la casella di controllo Attiva notifiche.

6. Dall'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 come preferisci.

9. Fai clic su Crea.

Dopo aver abilitato le notifiche, crea una sottoscrizione Pub/Sub per il tuo argomento.

Nota: GKE non ha limitazioni sulla correlazione tra gli argomenti e i cluster, a condizione che gli argomenti si trovino nello stesso progetto dei cluster. Puoi scegliere di creare un argomento per tutti i cluster o di creare più argomenti per gruppi di cluster.

Abilita le notifiche per i cluster esistenti

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

gcloud

Per abilitare le notifiche del cluster su un cluster esistente, esegui questo 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 computing per il nuovo cluster. Per i cluster standard di zona, utilizza --zone=COMPUTE_ZONE.
• PROJECT_ID: l'ID del tuo progetto Google Cloud.
• TOPIC_NAME: il nome dell'argomento Pub/Sub.

• NOTIFICATION_TYPE: un elenco delimitato da barre verticali (|) dei tipi di notifica 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 tuo cluster.

Console

Per abilitare le notifiche per un cluster esistente, esegui queste operazioni:

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. Dall'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 abilitato le notifiche, crea una sottoscrizione Pub/Sub per il tuo argomento.

Nota: GKE non ha limitazioni sulla correlazione tra gli argomenti e i cluster, a condizione che gli argomenti si trovino nello stesso progetto dei cluster. Puoi scegliere di creare un argomento per tutti i cluster o di creare più argomenti per gruppi di cluster

Filtra notifiche cluster

Puoi filtrare le notifiche per tipo di notifica per assicurarti di ricevere le notifiche desiderate.

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'abilitazione delle notifiche del cluster.
• Pub/Sub: configura la sottoscrizione Pub/Sub per filtrare i messaggi quando crei una sottoscrizione.

Nota: consigliamo di applicare i filtri utilizzando GKE. L'applicazione di filtri in GKE ti consente di modificare i filtri in qualsiasi momento ed elimina il costo dei messaggi non recapitati associato ai filtri Pub/Sub. Per scoprire di più sulle differenze tra le opzioni di filtro, consulta Filtro delle notifiche.

Modificare i filtri esistenti in GKE

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

Disabilita i filtri in GKE

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

gcloud

Per disabilitare i filtri utilizzando gcloud CLI, esegui questo comando:

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

Console

Per disabilitare i filtri utilizzando la console Google Cloud, esegui queste operazioni:

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

5. Fai clic su Salva modifiche.

Verifica la configurazione delle notifiche relative ai cluster

In modalità Autopilot, puoi verificare le notifiche del cluster come segue:

1. Avvia un upgrade del piano di controllo.
2. Attendi che GKE esegua automaticamente l'upgrade dei nodi alla nuova versione. Il tempo necessario può variare in base ai periodi di manutenzione e alle esclusioni configurati.
3. Dopo aver eseguito l'upgrade dei nodi di GKE, controlla la sottoscrizione 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 di GKE sui 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 carichi di lavoro in esecuzione.

2. Dopo aver eseguito l'upgrade dei nodi di GKE, controlla la sottoscrizione Pub/Sub.

Puoi verificare manualmente la configurazione solo per il tipo di notifica UpgradeEvent. Se i filtri sono configurati in modo da ignorare questo tipo, non verrà visualizzato alcun messaggio.

Disabilita notifiche cluster

Puoi disabilitare le notifiche dei cluster utilizzando gcloud CLI o la console Google Cloud.

gcloud

Per disabilitare le notifiche utilizzando gcloud CLI, esegui questo comando:

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

Console

Per disabilitare le notifiche utilizzando la console Google Cloud, segui questi 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.

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

Passaggi successivi

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