Inhalt des Nomos-Fehlerberichts

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

Sie können ähnliche Informationen von 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 Google Cloud Support wenden, ist es hilfreich, die nomos bugreport anzugeben.

Sie können die Ausgabe von nomos bugreport auch für Ihr eigenes Debugging oder den internen Support verwenden.

Die Dateistruktur der nomos bugreport-Ausgabe 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 mit nomos bugreport abrufen können:

1. „Nomos version“ zeigt die Config Sync-Version an, die Ausgabe von nomos version.
2. „Nomos status“ zeigt die Ausgabe von nomos status an, z. B. welcher Commit synchronisiert wurde und etwaige Fehler.
3. Informationen zu benutzerdefinierten Config Sync-Ressourcen:
   1. Clusterbezogene Ressourcen 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, befindet sich diese 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 die RepoSync API nicht aktiviert haben und Git-Felder in Ihrem ConfigManagement-Objekt (eingestellt) angeben, befindet sich der vollständige Inhalt der Ressourcen in ClusterConfigs und NamespaceConfigs. Sie sollten Ihr Objekt ConfigManagementmigrieren.
5. Logs aller Config Sync-Pods finden Sie unter raw/cluster-1/namespaces/pod-namespace-1/pod-name-1/container-name.txt.
6. Der vollständige Inhalt aller Config Sync-Pods befindet sich unter raw/cluster-1/namespaces/pod-namespace-1/pods.txt.
7. Sind die Config Sync RootSync API und RepoSync API aktiviert (d. h. wird der Multi-Repo-Modus verwendet) oder nicht?
   1. Prüfen Sie die ConfigManagement-Ressource. Wenn Sie spec.enableMultiRepo: true sehen, sind die RootSync API und die RepoSync API aktiviert.
   2. Wenn Sie Komponenten wie RootSync-, RepoSync- oder Abgleichs-Pods sehen, haben Sie die RootSync API und die RepoSync API aktiviert.
   3. Wenn Sie Komponenten wie den git-importer-Pod sehen, sind die RootSync API und die RepoSync API nicht aktiviert und Sie müssen Ihr Migrate your ConfigManagement object migrieren.