Se stai riscontrando difficoltà con Config Sync, questa pagina ti presenta alcuni strumenti e procedure comuni che possono aiutarti a identificare e risolvere i problemi riscontrati.
Esegui l'upgrade a una versione supportata
Valuta la possibilità di eseguire l'upgrade di Config Sync a una versione supportata. L'upgrade spesso risolve i problemi comuni e ti consente di accedere alle funzionalità più aggiornate. Per assicurarti di utilizzare sempre una versione supportata, puoi abilitare l'upgrade automatico (anteprima).
Utilizza lo strumento a riga di comando nomos
Lo strumento a riga di comando nomos
fornisce
insight essenziali sulla configurazione di Config Sync. I comandi descritti in
le sezioni seguenti sono particolarmente utili quando cerchi di determinare
l'origine del problema o quando devi contattare
l'assistenza clienti Google Cloud.
Visualizzare lo stato di Config Sync
Il comando
nomos status
fornisce dati e errori aggregati per aiutarti a capire
cosa sta succedendo con l'installazione di Config Sync. Le seguenti informazioni sono disponibili con nomos status
:
- Stato di installazione per cluster
- Errori di sincronizzazione (sia di lettura da Git che di riconciliazione delle modifiche)
Crea una segnalazione di bug
Se hai un problema con Config Sync che richiede l'assistenza dell'assistenza clienti Google Cloud, puoi fornire informazioni utili per il debug utilizzando il comando nomos bugreport
.
Questo comando genera un file ZIP con timestamp contenente informazioni sul cluster Kubernetes impostato nel contesto kubectl
. Il file contiene anche i log dei pod Config Sync. Non contiene informazioni sulle risorse sincronizzate
con Config Sync.
Visualizza la dashboard della panoramica
La Dashboard di Config Sync offre una panoramica dello stato dei pacchetti che Config Sync e lo stato delle risorse in questi pacchetti. Alla scoperta di questo dashboard può aiutarti a ottenere una rapida panoramica dello stato del tuo L'installazione di Config Sync e individua i pacchetti che presentano problemi.
Per accedere alla dashboard, nella console Google Cloud vai a Configurazione. nella sezione Funzionalità:
Utilizzare il monitoraggio e l'analisi dei log
Il monitoraggio di Config Sync e l'esplorazione dei relativi log possono aiutarti a determinare l'origine dei bug e comprendere meglio eventuali comportamenti imprevisti.
Informazioni sulle metriche di Config Sync
Utilizza le metriche di Config Sync per ottenere visibilità sull'integrità di Config Sync.
Monitoraggio di oggetti RootSync e RepoSync
Quando installi Config Sync utilizzando la console Google Cloud o Google Cloud CLI, Config Sync crea automaticamente un oggetto RootSync per te. Quando Configura la sincronizzazione da più repository, puoi creare oggetti RepoSync contenenti informazioni di configurazione nello spazio dei nomi dei repository.
Il monitoraggio di questi oggetti può rivelare informazioni preziose sullo stato di Config Sync. Per saperne di più, vedi Monitorare gli oggetti RootSync e RepoSync.
Utilizzare gli indicatori del livello del servizio (SLI)
Per ricevere notifiche quando Config Sync non funziona come previsto, utilizza gli SLI di Config Sync.
Log delle query
Puoi utilizzare Esplora log per recuperare, visualizzare e analizzare i dati dei log di Config Sync. Questi log possono
contengono dati storici importanti che non vengono acquisiti da nomos bugreport
quando
i pod dell'operatore o del riconciliatore vengono
riavviati. Per esempi di query
potrebbe aiutarti a diagnosticare il problema, consulta Log di Query Config Sync.
Esamina le risorse con lo strumento a riga di comando kubectl
Config Sync è composto da più risorse personalizzate in base alle quali puoi eseguire query
usando i comandi kubectl
. Questi comandi ti aiutano a comprendere lo stato di ciascun
oggetto di Config Sync.
Devi conoscere le seguenti informazioni sulle risorse Kubernetes gestite da Config Sync:
config-management-system
è lo spazio dei nomi che utilizziamo per eseguire tutti i componenti di sistema di base di Config Sync.configmanagement.gke.io
econfigsync.gke.io
sono i gruppi API che per tutte le risorse personalizzate.
Esempi
Le sezioni seguenti mostrano come utilizzare i comandi kubectl
per esaminare Config Sync.
Elenca risorse personalizzate
Puoi ottenere un elenco completo delle risorse personalizzate eseguendo questo :
kubectl api-resources | grep -E "configmanagement.gke.io|configsync.gke.io"
Le singole risorse personalizzate possono essere utilizzate eseguendo il seguente comando:
kubectl get RESOURCE -o yaml.
Sostituisci
RESOURCE
con il nome della risorsa per cui vuoi eseguire una query.Ad esempio, l'output del seguente comando consente di controllare lo stato di un oggetto RootSync:
kubectl get rootsync -n config-management-system -o yaml
Controlla l'annotazione del token di un oggetto
Potresti voler sapere quando un oggetto Kubernetes gestito è stato aggiornato l'ultima volta Config Sync. Ogni oggetto gestito è annotato con l'hash del Git eseguire il commit dell'ultima modifica e il percorso della configurazione modifica.
Ad esempio, per ottenere l'annotazione di un ClusterRoleBinding denominato
namespace-readers
, esegui questo comando:
kubectl get clusterrolebinding namespace-readers
L'output è simile al seguente:
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
annotations:
configmanagement.gke.io/source-path: cluster/namespace-reader-clusterrolebinding.yaml
configmanagement.gke.io/token: bbb6a1e2f3db692b17201da028daff0d38797771
name: namespace-readers
...
Per ulteriori informazioni, vedi etichette e annotazioni.
Leggi la documentazione aggiuntiva per la risoluzione dei problemi
Se continui a riscontrare problemi, le risorse riportate di seguito potrebbero essere utile:
Se hai ricevuto un messaggio di errore, leggi l'articolo sulla pagina di riferimento per consigli su come risolvere .
Controlla se il problema che stai riscontrando è causato da un problema noto.
Se hai difficoltà in un'area specifica, uno dei guide alla risoluzione dei problemi elencate nella sezione Risolvere i problemi in base al tipo di problema del il sommario potrebbe essere utile.
Passaggi successivi
- Se hai bisogno di ulteriore assistenza, contatta Assistenza clienti Google Cloud.