Introduzione alla risoluzione dei problemi

Se riscontri problemi con Config Sync, questa pagina introduce ad alcuni strumenti e procedure comuni che possono aiutarti a identificare e risolvere che riscontri.

Esegui l'upgrade a una versione supportata

Valuta la possibilità di eseguire l'upgrade Config Sync su un supportata . L'upgrade spesso risolve i problemi più comuni e consente di accedere le funzionalità attuali. Per assicurarti di utilizzare sempre una versione supportata, puoi abilitare l'upgrade automatico (anteprima).

Usa 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.

Visualizza lo stato di Config Sync

La nomos status fornisce dati aggregati ed errori per aiutarti a comprendere che cosa succede all'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 sia di riconciliazione delle modifiche)

Crea una segnalazione di bug

Se hai un problema con Config Sync che richiede assistenza da Assistenza clienti Google Cloud, puoi fornire loro preziose opportunità di debug le informazioni utilizzando Comando nomos bugreport.

Questo comando genera un file ZIP con timestamp che contiene informazioni cluster impostato nel tuo contesto kubectl. Il file contiene anche i log di 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à:

    Vai a Configurazione

Utilizza 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.

Comprendi le metriche di Config Sync

Utilizza le metriche di Config Sync e acquisire visibilità sull'integrità di Config Sync.

Monitoraggio di oggetti RootSync e RepoSync

Quando installi Config Sync utilizzando la console Google Cloud oppure 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 preziose informazioni sullo stato 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 per 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 ogni degli oggetti di Config Sync.

Dovresti conoscere le seguenti informazioni sulle risorse Kubernetes Config Sync gestisce:

  • config-management-system è lo spazio dei nomi che utilizziamo per eseguire tutte le applicazioni componenti di sistema di Config Sync.
  • configmanagement.gke.io e configsync.gke.io sono i gruppi API che per tutte le risorse personalizzate.

Esempi

Le sezioni seguenti mostrano come puoi 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"

  • Puoi utilizzare singole risorse personalizzate eseguendo questo comando:

    kubectl get RESOURCE -o yaml.

    Sostituisci RESOURCE con il nome della risorsa di cui su cui vuoi eseguire una query.

    Ad esempio, l'output del comando seguente consente di verificare 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 i problemi persistono, le risorse indicate di seguito potrebbero essere utile:

  • Se hai ricevuto un messaggio di errore, leggi l'articolo sulla pagina di riferimento per consigli su come risolvere .

  • Verifica 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