Contenu du rapport de bug nomos

L'outil de ligne de commande nomos facilite les tâches d'administration courantes pour Config Sync, par exemple la création d'une archive de diagnostic. La sortie et la mise en page exactes de l'archive sont susceptibles d'être modifiées et ne sont pas considérées comme une API. Le code de nomos est disponible dans le dépôt Config Sync.

Vous pouvez obtenir des informations similaires à partir de votre cluster en exécutant kubectl get ou kubectl logs, mais l'avantage de nomos bugreport est qu'il crée une archive des informations clés sur le système Config Sync. Lorsque vous contactez l'assistance Google Cloud , il est utile de fournir le résultat de nomos bugreport.

Vous pouvez également utiliser la sortie de nomos bugreport pour votre propre débogage ou pour l'assistance interne.

La structure du fichier de sortie nomos bugreport se présente comme suit :

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

Voici les informations que vous pouvez obtenir auprès de nomos bugreport :

  1. La version de Nomos correspond à la version de Config Sync, c'est-à-dire le résultat de nomos version.
  2. L'état Nomos affiche la sortie de l'état nomos status, par exemple le commit synchronisé et les éventuelles erreurs.
  3. Informations sur les ressources personnalisées Config Sync :
    1. Les ressources à l'échelle du cluster, telles que ConfigManagement et ClusterSelectors, se trouvent ici : raw/cluster-1/cluster/configmanagement/.
    2. Pour ceux à portée d'espace de noms, tels que RootSync, RepoSync et ResourceGroup, ils se trouvent ici : raw/cluster-1/namespaces/namespace-1.
  4. Ressources synchronisées et gérées par Config Sync :
    1. Si vous avez activé les API RootSync et RepoSync, il se trouve dans la spécification de ResourceGroup. Vous pouvez obtenir le nombre de ces ressources, ainsi que leur type, leur espace de noms et leur nom.
    2. Si les API RootSync et RepoSync ne sont pas activées et que vous spécifiez des champs Git dans votre objet ConfigManagement (obsolète), le contenu complet des ressources se trouve dans ClusterConfigs et NamespaceConfigs. Vous devez migrer votre objet ConfigManagement.
  5. Les journaux de tous les pods Config Sync se trouvent sous raw/cluster-1/namespaces/pod-namespace-1/pod-name-1/container-name.txt.
  6. Contenu complet de tous les pods Config Sync : sous raw/cluster-1/namespaces/pod-namespace-1/pods.txt.
  7. Les API RootSync et RepoSync de Config Sync sont-elles activées (c'est-à-dire en mode multi-dépôt) ou non ?
    1. Vérifiez la ressource ConfigManagement. Si vous voyez spec.enableMultiRepo: true, les API RootSync et RepoSync sont activées.
    2. Si vous voyez des composants tels que des pods RootSync, RepoSync ou de rapprochement, cela signifie que les API RootSync et RepoSync sont activées.
    3. Si vous voyez des composants tels que le pod git-importer, cela signifie que les API RootSync et RepoSync ne sont pas activées et que vous devez migrer votre objet ConfigManagement.