Supervisa objetos RootSync y RepoSync

En esta página, se muestran diferentes formas de supervisar los objetos RootSync y RepoSync.

View logs

En esta sección, se explica cómo ver los registros de los objetos RootSync y RepoSync. Ver los registros proporciona información sobre posibles errores.

  • Para ver los registros del conciliador de RootSync, ejecuta el siguiente comando:

    kubectl logs -n config-management-system deployment/root-reconciler CONTAINER_NAME
    

    Reemplaza CONTAINER_NAME por uno de los siguientes valores:

    • git-sync: El contenedor git-sync extrae las opciones de configuración de tu repositorio de Git a un directorio local que el contenedor del conciliador puede leer.

    • hydration-controller: El contenedor hydration-controller renderiza cualquier configuración de Helm o Kustomize que se extrajo de tu repositorio y, luego, guarda los archivos de configuración renderizados en el volumen compartido por el contenedor reconciler para más procesos.

    • otel-agent: El contenedor otel-agent es un agente de OpenTelemetry para recuperar y exportar las métricas del Sincronizador de configuración.

    • reconciler: El contenedor reconciler aplica esos archivos de configuración al clúster.

  • Para ver los registros del conciliador de RepoSync, ejecuta el siguiente comando:

    kubectl logs -n config-management-system deployment/ns-reconciler-NAMESPACE CONTAINER_NAME
    

    Reemplaza lo siguiente:

    • NAMESPACE: el espacio de nombres en el que creaste el repositorio del espacio de nombres.
    • CONTAINER_NAME: git-sync, hydration-controller, otel-agent o reconciler.

Visualiza confirmaciones sincronizadas

Puedes comprobar qué confirmación se sincroniza con el clúster.

  • Si deseas ver las confirmaciones sincronizadas para RootSync, ejecuta el siguiente comando:

    kubectl get rootsync root-sync -n config-management-system
    
  • Si deseas ver las confirmaciones sincronizadas para RepoSync, ejecuta el siguiente comando:

    kubectl get reposync repo-sync -n NAMESPACE
    

    Reemplaza NAMESPACE por el espacio de nombres en el que creaste el repositorio de espacio de nombres.

El resultado de estos comandos te muestra el valor de la confirmación de origen y la confirmación sincronizada. Por ejemplo, si ejecutas el comando para RepoSync, verás un resultado similar al siguiente:

NAME        RENDERINGCOMMIT                            SOURCECOMMIT                               SYNCCOMMIT
root-sync   66882815f0ef5517df27e864fb1315e97756ab72   66882815f0ef5517df27e864fb1315e97756ab72   66882815f0ef5517df27e864fb1315e97756ab72

El valor en la columna RENDERINGCOMMIT es la confirmación que procesa hydration-controller. Si no se necesita ninguna renderización, el valor es el mismo que el de la columna SOURCECOMMIT. El valor en la columna SOURCECOMMIT es la confirmación del repositorio de Git que se debe sincronizar con el clúster. El valor en la columna SYNCCOMMIT es la confirmación que se implementa en el clúster. Si los dos valores de las columnas SOURCECOMMIT y SYNCCOMMIT son los mismos, la confirmación esperada se implementó en el clúster.

Vizualiza detalles del objeto

Para ver los detalles de los objetos RootSync y RepoSync, usa kubectl describe. Este comando puede brindarte más información sobre posibles errores.

  • Para ver los detalles del objeto RootSync, ejecuta el siguiente comando:

    kubectl describe rootsync root-sync -n config-management-system
    
  • Para ver los detalles del objeto RepoSync, ejecuta el siguiente comando:

    kubectl describe reposync repo-sync -n NAMESPACE
    

    Reemplaza NAMESPACE por el espacio de nombres en el que creaste el repositorio de espacio de nombres.

Visualiza si un recurso está listo

Para saber si los recursos sincronizados con el clúster están listos, consulta el estado de conciliación. Por ejemplo, si ves el estado de conciliación, puedes ver si una implementación sincronizada está lista para entregar tráfico.

Para un repositorio de Git sincronizado con el clúster, los estados de conciliación de todos los recursos se agregan en un recurso llamado ResourceGroup. Para cada objeto RootSync o RepoSync, se genera un ResourceGroup a fin de capturar el conjunto de recursos aplicados al clúster y los estados agregados.

  • Para ver el estado de conciliación del objeto RootSync, ejecuta el siguiente comando:

    kubectl get resourcegroup.kpt.dev root-sync -n config-management-system -o yaml
    
  • Para ver el estado de conciliación del objeto RepoSync, ejecuta el siguiente comando:

    kubectl get resourcegroup.kpt.dev repo-sync -n NAMESPACE -o yaml
    

    Reemplaza NAMESPACE por el espacio de nombres en el que creaste el repositorio de espacio de nombres.

En el resultado, verás todos los estados de los recursos de ResourceGroup. Por ejemplo, el siguiente resultado muestra que una implementación llamada nginx-deployment está lista:

resourceStatuses:
- group: apps
  kind: Deployment
  name: nginx-deployment
  namespace: default
  status: Current

¿Qué sigue?