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, la producción de un archivo de diagnóstico. El diseño y el resultado 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 comuniques con el equipo de asistencia, será útil que proporciones el resultado de nomos bugreport. Google Cloud

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, la salida de nomos version.
  2. El estado de Nomos muestra el resultado del estado de nomos status, por ejemplo, qué confirmación se sincronizó y los errores.
  3. Información sobre los recursos personalizados de Sincronizador de configuración:
    1. Los recursos con permisos de clústeres, como ConfigManagement y ClusterSelectors, se encuentran aquí: raw/cluster-1/cluster/configmanagement/.
    2. Para los que tienen permisos 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, así como 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 se encuentra 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 de Config Sync: en raw/cluster-1/namespaces/pod-namespace-1/pods.txt
  7. ¿Están habilitadas las APIs de RootSync y RepoSync de Config Sync (es decir, se usa 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, significa que las APIs de RootSync y RepoSync no están habilitadas y debes migrar tu objeto ConfigManagement.