contenuti della segnalazione di bug nomos

Lo strumento a riga di comando nomos è utile per le attività amministrative comuni per Config Sync, ad esempio per generare un archivio di diagnostica. L'output e il layout esatti dell'archivio sono soggetti a modifiche e non sono considerati un'API. Il codice per nomos è disponibile nel repository Config Sync.

Puoi ottenere informazioni simili dal tuo cluster eseguendo kubectl get o kubectl logs, ma il vantaggio di nomos bugreport è che crea un archivio di informazioni chiave sul sistema Config Sync. Quando contatti l'assistenza Google Cloud, è utile fornire l'output nomos bugreport.

Puoi anche utilizzare l'output di nomos bugreport per il debug o per assistenza interna.

La struttura del file di output nomos bugreport ha il seguente aspetto:

- raw/
  - cluster/
    - configmanagement/
  - namespaces/
    - config-management-monitoring/
    - config-management-system/
    - gatekeeper-system/
    - resource-group-system/
    - kube-system/
- processed/
  - status.txt
  - version.txt

Informazioni che puoi recuperare da nomos bugreport:

  1. La versione di Nomos mostra la versione di Config Sync, l'output di nomos version.
  2. Lo stato Nomos mostra l'output dello stato nomos status, ad esempio il commit sincronizzato ed eventuali errori.
  3. Informazioni sulle risorse personalizzate di Config Sync:
    1. Per le risorse con ambito cluster, come ConfigManagement e ClusterSelectors, si trovano qui: raw/cluster-1/cluster/configmanagement/.
    2. Per quelli con ambito dello spazio dei nomi, come RootSync, RepoSync e ResourceGroup, si trovano qui: raw/cluster-1/namespaces/namespace-1.
  4. Risorse sincronizzate e gestite da Config Sync:
    1. Se hai abilitato le API RootSync e RepoSync, è nelle specifiche di ResourceGroup. Puoi ottenere il conteggio delle risorse e il tipo, lo spazio dei nomi e il nome corrispondenti.
    2. Se non hai abilitato le API RootSync e RepoSync e specifichi campi git nell'oggetto ConfigManagement (deprecato), l'intero contenuto delle risorse si troverà nei cluster ClusterConfigs e NamespaceConfigs. Devi eseguire la migrazione dell'oggetto ConfigManagement.
  5. I log di tutti i pod di Config Sync si trovano in raw/cluster-1/namespaces/pod-namespace-1/pod-name-1/container-name.txt.
  6. I contenuti completi di tutti i pod di Config Sync: in raw/cluster-1/namespaces/pod-namespace-1/pods.txt.
  7. Le API RootSync e RepoSync di Config Sync sono abilitate (ovvero, in modalità multi-repository)?
    1. Controlla la risorsa ConfigManagement e, se vedi spec.enableMultiRepo: true, le API RootSync e RepoSync sono abilitate.
    2. Se vedi componenti come RootSync, RepoSync o pod di riconciliazione, significa che le API RootSync e RepoSync sono abilitate.
    3. Se vedi componenti come il pod git-importer, significa che le API RootSync e RepoSync non sono abilitate e devi eseguire la migrazione dell'oggetto ConfigManagement.