Questa pagina mostra come utilizzare Pub/Sub per ricevere notifiche su nei cluster Google Kubernetes Engine (GKE).
Panoramica
Quando si verificano determinati eventi rilevanti per i tuoi cluster GKE, importanti upgrade pianificati o bollettini sulla sicurezza disponibili, pubblica notifiche su questi eventi come messaggi negli argomenti Pub/Sub configurato. Puoi ricevere queste notifiche su Pub/Sub abbonamento, eseguire l'integrazione con servizi di terze parti, e filtrarli in base ai tipi di notifiche che vuoi ricevere.
Per scoprire di più sui vantaggi delle notifiche del cluster, sul funzionamento delle notifiche, e perché è importante filtrare, consulta Notifiche relative ai cluster. Puoi configurare le notifiche del cluster in cluster standard nuovi ed esistenti e aggiornando Autopilot esistenti.
Prima di iniziare
Prima di iniziare, assicurati di aver eseguito le seguenti attività:
- Attiva l'API Google Kubernetes Engine. Abilita 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, scarica la versione più recente
eseguendo
gcloud components update
.
- Crea un argomento Pub/Sub in del progetto.
Abilita le notifiche su un nuovo cluster
Puoi attivare le notifiche dei cluster GKE su un nuovo cluster standard utilizzando la CLI Google Cloud 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 computing per il nuovo cluster. Per i cluster standard a livello di zona, utilizza--zone=COMPUTE_ZONE
.PROJECT_ID
: il tuo ID progetto Google Cloud.TOPIC_NAME
: il nome del tuo argomento Pub/Sub.NOTIFICATION_TYPE
: un elenco delimitato da barre verticali (|) delle i tipi di notifica che desideri ricevere. Ad esempio,filter="UpgradeEvent|SecurityBulletinEvent"
invia solo notificheUpgradeEvent
eSecurityBulletinEvent
, ignorando tutti gli altri tipi.
Console
Per abilitare le notifiche su un nuovo cluster Standard, segui 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 notifica che vuoi ricevere.
Continua a configurare il cluster come preferisci.
Fai clic su Crea.
Dopo aver abilitato le notifiche, crea un abbonamento Pub/Sub per il tuo argomento.
Attivare le notifiche del cluster in un cluster esistente
Puoi abilitare le notifiche del cluster GKE su una utilizzando Google Cloud CLI o la console Google Cloud.
gcloud
Per abilitare le notifiche 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 zonali, utilizza--zone=COMPUTE_ZONE
.PROJECT_ID
: il tuo ID progetto Google Cloud.TOPIC_NAME
: il nome del tuo argomento Pub/Sub.NOTIFICATION_TYPE
: un elenco delimitato da barre verticali (|) delle i tipi di notifica che desideri 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, svolgi i seguenti 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 Attiva notifiche. casella di controllo.
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 notifica che vuoi ricevere.
Fai clic su Salva modifiche.
Dopo aver abilitato le notifiche, crea un abbonamento Pub/Sub per il tuo argomento.
Filtra notifiche 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
in--notification-config
come mostrato negli esempi precedenti per l'abilitazione delle notifiche del cluster. - Pub/Sub: configura la tua sottoscrizione Pub/Sub per filtrare i messaggi quando crei un abbonamento.
Modifica 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 selezionali nella console Google Cloud.
Disattivare i filtri in GKE
Puoi disabilitare i filtri delle notifiche GKE e ricevere tipi di notifiche applicabili al cluster con 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 disabilitare i filtri 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 Filtra tipi di notifiche casella di controllo.
Fai clic su Salva modifiche.
Verifica la configurazione per le notifiche del 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 ed esclusioni.
- Dopo che GKE ha eseguito l'upgrade dei nodi, verifica la tua sottoscrizione 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 cambiare la versione GKE sui nodi, puoi eseguire l'upgrade alla stessa versione attualmente sui nodi.
Dopo che GKE ha eseguito l'upgrade dei nodi, verifica la tua sottoscrizione Pub/Sub.
Puoi verificare manualmente la configurazione solo per il tipo di notifica UpgradeEvent
. Se
Se i filtri sono configurati in modo da ignorare questo tipo, non verrà visualizzato alcun messaggio.
Disabilita notifiche cluster
Puoi disabilitare le notifiche relative al cluster utilizzando gcloud CLI o nella 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, esegui la seguenti:
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 Attiva notifiche. casella di controllo.
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 dei cluster.
- Scopri di più sulla configurazione delle notifiche Pub/Sub.
- Scopri come configurare le notifiche dei cluster per i servizi di terze parti.