Inhalt des Nomos-Fehlerberichts

Das nomos-Befehlszeilentool unterstützt Sie bei gängigen Verwaltungsaufgaben für Config Sync, z. B. beim Erstellen eines Diagnosearchivs. Die genaue Ausgabe und das Layout des Archivs können sich ändern und gelten nicht als API. Der Code für nomos ist im Config Sync-Repository verfügbar.

Sie können ähnliche Informationen aus Ihrem Cluster abrufen, indem Sie kubectl get oder kubectl logs ausführen. Der Vorteil von nomos bugreport besteht jedoch darin, dass ein Archiv mit wichtigen Informationen zum Config Sync-System erstellt wird. Wenn Sie sich an den Cloud de Confiance by S3NS Support wenden, ist es hilfreich, die Ausgabe von nomos bugreport anzugeben.

Sie können die Ausgabe von nomos bugreport auch für die eigene Fehlersuche oder den internen Support verwenden.

Die Struktur der nomos bugreport-Ausgabedatei sieht so aus:

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

Informationen, die Sie von nomos bugreport erhalten können:

1. Die Nomos-Version entspricht der Config Sync-Version, der Ausgabe von nomos version.
2. Der Nomos-Status zeigt die Ausgabe von nomos status-Status an, z. B. welcher Commit synchronisiert wird und etwaige Fehler.
3. Informationen zu benutzerdefinierten Config Sync-Ressourcen:
   1. Clusterressourcen wie ConfigManagement und ClusterSelectors befinden sich hier: raw/cluster-1/cluster/configmanagement/.
   2. Namespace-bezogene Ressourcen wie RootSync, RepoSync und ResourceGroup befinden sich hier: raw/cluster-1/namespaces/namespace-1.
4. Von Config Sync synchronisierte und verwaltete Ressourcen:
   1. Wenn Sie die RootSync API und die RepoSync API aktiviert haben, finden Sie die Informationen in der Spezifikation von ResourceGroup. Sie können die Anzahl dieser Ressourcen sowie ihre Art, ihren Namespace und ihren Namen abrufen.
   2. Wenn Sie die RootSync API und RepoSync API nicht aktiviert haben und Git-Felder in Ihrem ConfigManagement-Objekt (deprecated) angeben, befindet sich der vollständige Inhalt der Ressourcen in ClusterConfigs und NamespaceConfigs. Sie sollten Ihr ConfigManagement-Objekt migrieren.
5. Logs aller Config Sync-Pods befinden sich unter raw/cluster-1/namespaces/pod-namespace-1/pod-name-1/container-name.txt.
6. Der vollständige Inhalt aller Config Sync-Pods: unter raw/cluster-1/namespaces/pod-namespace-1/pods.txt.
7. Sind die RootSync- und RepoSync APIs von Config Sync aktiviert (d. h. wird der Multi-Repo-Modus verwendet)?
   1. Prüfen Sie die ConfigManagement-Ressource. Wenn Sie spec.enableMultiRepo: true sehen, sind die RootSync- und RepoSync APIs aktiviert.
   2. Wenn Sie Komponenten wie RootSync-, RepoSync- oder Abgleicher-Pods sehen, haben Sie die RootSync- und RepoSync APIs aktiviert.
   3. Wenn Sie Komponenten wie den Pod „git-importer“ sehen, sind die RootSync- und RepoSync-APIs nicht aktiviert und Sie müssen Ihr ConfigManagement-Objekt migrieren.