Questa pagina mostra come utilizzare Pub/Sub per ricevere notifiche sui tuoi cluster Google Kubernetes Engine (GKE).
Per impostazione predefinita, GKE esegue il routing di queste notifiche a Cloud Logging. Puoi utilizzare tutte le funzionalità di Cloud Logging, tra cui l'esecuzione di query e la visualizzazione dei log e la configurazione di criteri di avviso basati sui log. Per trovare questi log in Cloud Logging, consulta Visualizzazione delle notifiche del cluster in Cloud Logging.
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 di cluster, su come funzionano le notifiche e sul motivo per cui il filtraggio è importante, consulta Notifiche di cluster. Puoi configurare le notifiche del 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à,
installala e poi
inizializzala. Se hai già installato gcloud CLI, scarica l'ultima versione eseguendo
gcloud components update
.
- Crea un argomento Pub/Sub nel tuo progetto.
Abilitare le notifiche del cluster in un nuovo cluster
Puoi abilitare le notifiche del cluster GKE su un nuovo cluster Standard utilizzando Google Cloud CLI o la console Google Cloud . Per attivare la notifica 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 del cluster su un nuovo cluster, esegui questo comando:
gcloud container clusters create CLUSTER_NAME \
--location=CONTROL_PLANE_LOCATION \
--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.CONTROL_PLANE_LOCATION
: la posizione di Compute Engine del control plane del tuo cluster. Fornisci una regione per i cluster regionali o una zona per i cluster zonali.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 notificheUpgradeEvent
eSecurityBulletinEvent
, ignorando tutti gli altri tipi.
Console
Per attivare le notifiche del cluster in un nuovo cluster Standard:
Vai alla pagina Google Kubernetes Engine nella console Google Cloud .
Fai clic su add_box Crea.
Nella finestra di dialogo Crea cluster, accanto a GKE Standard, fai clic su Configura.
Nel riquadro di navigazione, nella sezione Cluster, fai clic su Automazione.
Seleziona la casella di controllo Attiva notifiche.
Nell'elenco a discesa, seleziona l'argomento Pub/Sub che hai creato.
Per filtrare le notifiche, seleziona la casella di controllo Filtra i tipi di notifica, quindi seleziona i tipi di notifica che vuoi ricevere.
Continua a configurare il cluster.
Fai clic su Crea.
Dopo aver attivato le notifiche, scegli il tipo di iscrizione per l'argomento.
Abilitare le notifiche del cluster su 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 questo comando:
gcloud container clusters update CLUSTER_NAME \
--location=CONTROL_PLANE_LOCATION \
--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.CONTROL_PLANE_LOCATION
: la posizione di Compute Engine del control plane del tuo cluster. Fornisci una regione per i cluster regionali o una zona per i cluster zonali.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 notificheUpgradeEvent
eSecurityBulletinEvent
, ignorando tutti gli altri tipi.
Console
Per attivare le notifiche del cluster su un cluster esistente:
Vai alla pagina Google Kubernetes Engine nella console Google Cloud .
Fai clic sul nome del cluster da modificare.
Nella sezione Automazione, accanto a Notifiche, fai clic su
Modifica notifiche.Nella finestra di dialogo Modifica notifiche, seleziona la casella di controllo Attiva notifiche.
Nell'elenco a discesa, seleziona l'argomento Pub/Sub che hai creato.
Per filtrare le notifiche, seleziona la casella di controllo Filtra i tipi di notifica, quindi seleziona i tipi di notifica che vuoi ricevere.
Fai clic su Salva modifiche.
Dopo aver attivato le notifiche, scegli il tipo di iscrizione per l'argomento.
Filtrare le notifiche dei cluster
Puoi filtrare le notifiche per tipo di notifica per assicurarti di ricevere le notifiche 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 la sottoscrizione Pub/Sub per filtrare i messaggi quando crei una sottoscrizione.
Modificare i filtri esistenti in GKE
Per modificare i filtri di notifica del cluster GKE esistente, segui le
istruzioni riportate in Attivare le notifiche su un cluster esistente
e specifica i nuovi tipi di notifica da filtrare nel comando gcloud
o seleziona i nuovi tipi nella console Google Cloud .
Disabilitare i filtri in GKE
Puoi disattivare i filtri delle notifiche GKE e ricevere tutti i tipi di notifiche applicabili al tuo cluster utilizzando gcloud CLI o la console Google Cloud .
gcloud
Per disattivare i filtri utilizzando gcloud CLI, esegui questo comando:
gcloud container clusters update CLUSTER_NAME \
--location=CONTROL_PLANE_LOCATION \
--notification-config=pubsub=ENABLED,pubsub-topic=projects/PROJECT_ID/topics/TOPIC_NAME
Console
Per disattivare i filtri utilizzando la console Google Cloud :
Vai alla pagina Google Kubernetes Engine nella console Google Cloud .
Fai clic sul nome del cluster da modificare.
Nella sezione Automazione, accanto a Notifiche, fai clic su
Modifica notifiche.Nella finestra di dialogo Modifica notifiche, deseleziona la casella di controllo Filtra i tipi di notifica.
Fai clic su Salva modifiche.
Verificare la configurazione delle notifiche del cluster
In modalità Autopilot, puoi verificare le notifiche del cluster nel seguente modo:
- Avvia un upgrade del control plane.
- Attendi che GKE esegua automaticamente l'upgrade dei nodi alla nuova versione. Il tempo impiegato può variare in base ai periodi di manutenzione e alle esclusioni configurate.
- Dopo che GKE esegue l'upgrade dei nodi, controlla l'abbonamento a Pub/Sub.
In modalità Standard, puoi verificare le notifiche del cluster nel seguente modo:
Esegui l'upgrade di un pool di nodi specifico a una nuova versione. Se non vuoi modificare la versione GKE sui nodi, puoi eseguire l'upgrade alla stessa versione attualmente presente sui nodi.
Dopo che GKE esegue l'upgrade dei nodi, controlla l'abbonamento a Pub/Sub.
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.
Disattivare le notifiche del cluster
Puoi disattivare le notifiche del cluster utilizzando gcloud CLI o la consoleGoogle Cloud .
gcloud
Per disattivare le notifiche utilizzando gcloud CLI, esegui questo comando:
gcloud container clusters update CLUSTER_NAME \
--location=CONTROL_PLANE_LOCATION \
--notification-config=pubsub=DISABLED
Console
Per disattivare le notifiche utilizzando la console Google Cloud , segui questi passaggi:
Vai alla pagina Google Kubernetes Engine nella console Google Cloud .
Fai clic sul nome del cluster da modificare.
Nella sezione Automazione, accanto a Notifiche, fai clic su
Modifica notifiche.Nella finestra di dialogo Modifica notifiche, deseleziona la casella di controllo Attiva notifiche.
Fai clic su Salva modifiche.
(Facoltativo) Elimina l'argomento Pub/Sub che hai creato per le notifiche.
Passaggi successivi
- Scopri di più sulle notifiche di cluster.
- Scopri di più sulla configurazione delle notifiche Pub/Sub.
- Scopri come configurare le notifiche dei cluster per i servizi di terze parti.