Ricevi notifiche relative al cluster

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

Panoramica

Quando si verificano determinati eventi pertinenti per i cluster GKE, ad esempio importanti upgrade pianificati o bollettini sulla sicurezza disponibili, GKE pubblica notifiche su questi eventi come messaggi negli argomenti Pub/Sub configurati. Puoi ricevere queste notifiche in un abbonamento Pub/Sub, integrarti con servizi di terze parti e filtrare in base ai tipi di notifiche che vuoi ricevere.

Per scoprire di più sui vantaggi delle notifiche relative al cluster, sul funzionamento delle notifiche e sul motivo per cui il filtro è importante, consulta Notifiche del cluster.

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 poi inizializza l'interfaccia a riga di comando gcloud.
  Nota: per le installazioni dell'interfaccia a riga di comando gcloud esistenti, assicurati di impostare le proprietà compute/region e compute/zone. Impostando le località predefinite, puoi evitare errori nell'interfaccia a riga di comando gcloud come segue: One of [--zone, --region] must be supplied: Please specify location.

• Crea un argomento Pub/Sub nel tuo progetto.

Abilita le notifiche su un nuovo cluster

Puoi abilitare le notifiche del cluster GKE su un nuovo cluster utilizzando Google Cloud CLI o Google Cloud Console.

gcloud

Per abilitare le notifiche sui cluster su un nuovo cluster, esegui il comando seguente:

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: l'area geografica di calcolo del nuovo cluster. Per i cluster di zona, utilizza --zone=COMPUTE_ZONE.
• PROJECT_ID: il tuo ID progetto Google Cloud.
• TOPIC_NAME: il nome dell'argomento Pub/Sub.

• NOTIFICATION_TYPE: una barra verticale (|) delimitata dai tipi di notifica che vuoi ricevere. Ad esempio, filter="UpgradeEvent|SecurityBulletinEvent" invia solo le 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 attivare le notifiche sui cluster in un nuovo cluster, esegui queste operazioni:

1. Vai alla pagina Google Kubernetes Engine in Google Cloud Console.

   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. Nella sezione Cluster del riquadro di navigazione, fai clic su Automazione.

5. Seleziona la casella di controllo Abilita 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 notifiche 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 attivato le notifiche, crea una sottoscrizione Pub/Sub per il tuo argomento.

Nota: GKE non ha limitazioni sulla modalità di correlazione degli argomenti con i cluster, purché gli argomenti siano 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 sui cluster su un cluster esistente

Puoi abilitare le notifiche del cluster GKE su un cluster esistente utilizzando Google Cloud CLI o Google Cloud Console.

gcloud

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

• NOTIFICATION_TYPE: una barra verticale (|) delimitata dai tipi di notifica che vuoi ricevere. Ad esempio, filter="UpgradeEvent|SecurityBulletinEvent" invia solo le 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 sul cluster su un cluster esistente, esegui queste operazioni:

1. Vai alla pagina Google Kubernetes Engine in Google Cloud Console.

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

Nota: GKE non ha limitazioni sulla modalità di correlazione degli argomenti con i cluster, purché gli argomenti siano 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 che preferisci.

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 sui cluster.
• Pub/Sub: configura la tua sottoscrizione Pub/Sub per filtrare i messaggi quando crei una sottoscrizione.

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

Modificare i filtri esistenti in GKE

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

Disabilita i filtri in GKE

Puoi disattivare i filtri delle notifiche di GKE e ricevere tutti i tipi di notifica applicabili al tuo cluster utilizzando l'interfaccia a riga di comando gcloud o Google Cloud Console.

gcloud

Per disabilitare i filtri utilizzando l'interfaccia a riga di comando gcloud, esegui il comando seguente:

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 Google Cloud Console, esegui queste operazioni:

1. Vai alla pagina Google Kubernetes Engine in Google Cloud Console.

   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.

Verifica la configurazione delle notifiche dei cluster

Per verificare che le notifiche siano configurate correttamente per il tuo cluster, puoi avviare un upgrade del pool di nodi per vedere se viene inviato un messaggio UpgradeEvent. Puoi verificare manualmente la configurazione solo per il tipo di notifica UpgradeEvent. Se i filtri sono configurati per ignorare questo tipo, non vedrai alcun messaggio.

Attenzione: l'upgrade manuale del pool di nodi ignora i periodi di manutenzione configurati e potrebbe causare interruzioni dei carichi di lavoro in esecuzione.

Puoi eseguire manualmente l'upgrade di un pool di nodi specifico utilizzando l'interfaccia a riga di comando gcloud o la console Google Cloud. Per istruzioni, consulta Upgrade manuale di un cluster o pool di nodi. Se non vuoi modificare la versione GKE sui tuoi nodi, puoi eseguire l'upgrade alla stessa versione attualmente presente sui nodi.

Dopo aver avviato l'upgrade, controlla se nella tua sottoscrizione Pub/Sub è presente un messaggio di notifica.

Disabilita notifiche cluster

Puoi disattivare le notifiche del cluster utilizzando l'interfaccia a riga di comando gcloud o la console Google Cloud.

gcloud

Per disabilitare le notifiche utilizzando l'interfaccia a riga di comando gcloud, esegui il comando seguente:

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

console

Per disabilitare le notifiche utilizzando Google Cloud Console, esegui queste operazioni:

1. Vai alla pagina Google Kubernetes Engine in Google Cloud Console.

   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 Abilita 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 al cluster.
• Scopri di più sulla configurazione delle notifiche Pub/Sub.
• Scopri come configurare le notifiche del cluster per i servizi di terze parti.