Contenido de bugreport de nomos

La herramienta de línea de comandos nomos ayuda con las tareas administrativas comunes del Sincronizador de configuración, por ejemplo, producir un archivo de diagnóstico. El resultado y el diseño exactos del archivo están sujetos a cambios y no se consideran una API. El código de nomos está disponible en el repositorio del Sincronizador de configuración.

Puedes obtener información similar de tu clúster ejecutando kubectl get o kubectl logs, pero la ventaja de nomos bugreport es que crea un archivo de información clave sobre el sistema del Sincronizador de configuración. Cuando te comunicas con el equipo de asistencia Google Cloud , es útil proporcionar el resultado de nomos bugreport.

También puedes usar el resultado de nomos bugreport para tu propia depuración o asistencia interna.

La estructura del archivo de salida de nomos bugreport se ve de la siguiente manera:

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

La información que puedes obtener de nomos bugreport es la siguiente:

  1. La versión de Nomos muestra la versión del Sincronizador de configuración, el resultado de nomos version.
  2. El estado de Nomos muestra el resultado del estado nomos status, por ejemplo, qué confirmación se sincroniza y los errores.
  3. Información sobre los recursos personalizados del Sincronizador de configuración:
    1. Para los recursos con alcance de clúster, como ConfigManagement y ClusterSelectors, se encuentran aquí: raw/cluster-1/cluster/configmanagement/.
    2. Para los que tienen alcance de espacio de nombres, como RootSync, RepoSync y ResourceGroup, se encuentran aquí: raw/cluster-1/namespaces/namespace-1.
  4. Recursos sincronizados y administrados por el Sincronizador de configuración:
    1. Si tienes habilitadas las APIs de RootSync y RepoSync, se encuentra en la especificación de ResourceGroup. Puedes obtener el recuento de esos recursos, su tipo, espacio de nombres y nombre.
    2. Si no tienes habilitadas las APIs de RootSync y RepoSync y especificas campos de Git en tu objeto ConfigManagement (obsoleto), el contenido completo de los recursos está en ClusterConfigs y NamespaceConfigs. Debes migrar tu objeto ConfigManagement.
  5. Los registros de todos los pods del Sincronizador de configuración se encuentran en raw/cluster-1/namespaces/pod-namespace-1/pod-name-1/container-name.txt.
  6. El contenido completo de todos los pods del Sincronizador de configuración se encuentra en raw/cluster-1/namespaces/pod-namespace-1/pods.txt.
  7. ¿Están habilitadas las APIs de RootSync y RepoSync del Sincronizador de configuración (es decir, con el modo de varios repositorios) o no?
    1. Verifica el recurso ConfigManagement y, si ves spec.enableMultiRepo: true, las APIs de RootSync y RepoSync están habilitadas.
    2. Si ves componentes como RootSync, RepoSync o pods de reconciliador, tienes habilitadas las APIs de RootSync y RepoSync.
    3. Si ves componentes como el pod git-importer, las APIs de RootSync y RepoSync no están habilitadas y debes migrar tu objeto ConfigManagement.