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 come messaggi negli argomenti Pub/Sub che hai configurato. Puoi ricevere queste notifiche in un abbonamento Pub/Sub, integrare con servizi di terze parti e filtrare in base ai tipi di notifiche che vuoi ricevere.
Per scoprire di più sui vantaggi delle notifiche sui cluster, su come funzionano le notifiche e sull'importanza dei filtri, consulta Notifiche sul 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 attività:
- Abilita l'API Google Kubernetes Engine. Abilita l'API Google Kubernetes Engine
- Se vuoi utilizzare Google Cloud CLI per questa attività, installa e inizializza l'interfaccia alla gcloud CLI. Se hai già installato l'interfaccia a riga di comando gcloud, scarica la versione più recente eseguendo
gcloud components update
.
- Crea un argomento Pub/Sub nel progetto.
Abilita le notifiche sul cluster su un nuovo cluster
Puoi abilitare le notifiche dei cluster GKE su un nuovo cluster standard utilizzando Google Cloud CLI o la console Google Cloud. Per abilitare la notifica sui cluster Autopilot, devi prima creare un cluster Autopilot e quindi aggiornare il cluster per utilizzare le notifiche cluster.
gcloud
Per abilitare le notifiche sui cluster su 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
: l'area geografica di calcolo per il nuovo cluster. Per i cluster standard 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 notificheUpgradeEvent
eSecurityBulletinEvent
, ignorando tutti gli altri tipi.
Console
Per abilitare le notifiche sui cluster in un nuovo cluster standard, esegui questi passaggi:
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.
Dall'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 notifiche che vuoi ricevere.
Continua a configurare il cluster come preferisci.
Fai clic su Crea.
Dopo aver attivato le notifiche, crea una sottoscrizione Pub/Sub per l'argomento.
Abilita notifiche cluster su un cluster esistente
Puoi abilitare le notifiche dei cluster GKE su un cluster esistente utilizzando Google Cloud CLI o la console Google Cloud.
gcloud
Per abilitare le notifiche sui 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
: l'area geografica di calcolo per il nuovo cluster. Per i cluster standard 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 notificheUpgradeEvent
eSecurityBulletinEvent
, ignorando tutti gli altri tipi.
Console
Per abilitare le notifiche sui cluster esistenti, esegui 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, seleziona la casella di controllo Attiva notifiche.
Dall'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 notifiche che vuoi ricevere.
Fai clic su Salva modifiche.
Dopo aver attivato le notifiche, crea una sottoscrizione Pub/Sub per l'argomento.
Filtra notifiche relative al cluster
Puoi filtrare le notifiche in base al tipo di notifica per assicurarti di ricevere quelle desiderate.
Puoi scegliere di filtrare le notifiche utilizzando i seguenti metodi:
- GKE: specifica i valori di
filter
nel flag--notification-config
, come mostrato negli esempi precedenti per abilitare le notifiche del cluster. - Pub/Sub: configura la sottoscrizione Pub/Sub per il filtro dei messaggi quando crei una sottoscrizione.
Modificare i filtri esistenti in GKE
Per modificare i filtri delle notifiche del cluster GKE esistenti, segui le istruzioni in Abilita le notifiche su un cluster esistente e specifica i nuovi tipi di notifiche da filtrare nel comando gcloud
o 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 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 la console Google Cloud, procedi nel seguente modo:
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.
Verifica la configurazione delle notifiche relative al cluster
In modalità Autopilot, puoi verificare le notifiche del cluster come segue:
- Avvia un upgrade del piano di controllo.
- Attendi che GKE esegua automaticamente l'upgrade dei nodi alla nuova versione. Il tempo impiegato potrebbe variare in base ai periodi di manutenzione configurati e alle esclusioni.
- Dopo che GKE ha eseguito l'upgrade dei nodi, controlla il tuo abbonamento Pub/Sub.
In modalità Standard, puoi verificare le notifiche del cluster come segue:
Esegui l'upgrade di un pool di nodi specifico a una nuova versione. Se non vuoi modificare la versione di GKE sui tuoi nodi, puoi eseguire l'upgrade alla stessa versione attualmente sui nodi.
Dopo che GKE ha eseguito l'upgrade dei nodi, controlla il tuo abbonamento Pub/Sub.
Puoi verificare manualmente la configurazione solo per il tipo di notifica UpgradeEvent
. Se i filtri sono configurati per 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 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 la console Google Cloud, procedi nel seguente modo:
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 Abilita notifiche.
Fai clic su Salva modifiche.
Facoltativamente, 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.