Visualiza el estado del Sincronizador de configuración en varios clústeres

Si instalas y configuras el Sincronizador de configuración en varios clústeres registrados en un proyecto, puedes usar gcloud alpha anthos config sync repo para enumerar el estado del repositorio que se sincroniza entre clústeres y depurar problemas del Sincronizador de configuración. En comparación con nomos status, gcloud alpha anthos config sync repo agrupa el estado por repositorio, mientras que el comando nomos status agrupa el estado por clúster.

Antes de comenzar

Antes de usar gcloud alpha anthos config sync repo, completa los siguientes pasos:

  1. Actualiza los componentes de la herramienta de línea de comandos de gcloud mediante la ejecución del siguiente comando:

    gcloud components update
    
  2. Registra tus clústeres si aún no lo hiciste. Si instalaste y configuraste el Sincronizador de configuración a través de la consola, puedes omitir este paso.

  3. Los administradores de la plataforma deben configurar la la puerta de enlace de Connect para el clúster registrado.

  4. Ejecuta el siguiente comando para configurar tu proyecto:

    gcloud config set project PROJECT_ID
    

    Reemplaza PROJECT_ID por el ID del proyecto en el que el Sincronizador de configuración está configurado y en ejecución.

Uso básico

Enumera todos los repositorios

   gcloud alpha anthos config sync repo list

Este comando enumera todo el estado de los repositorios de Git que se sincronizan con cualquier clúster registrado en el proyecto actual. El resultado es similar a este:

┌─────────────────────────────────────────────────────────────────┬───────┬────────┬─────────┬───────┬─────────┬─────────────┐
│                       SOURCE                                    │ TOTAL │ SYNCED │ PENDING │ ERROR │ STALLED │ RECONCILING │
├─────────────────────────────────────────────────────────────────┼───────┼────────┼─────────┼───────┼─────────┼─────────────┤
│ https://source.developers.google.com/p/test/r/test//@main       │ 2     │ 2      │ 0       │ 0     │ 0       │ 0           │
│ https://source.developers.google.com/p/test/r/dev//@main        │ 2     │ 1      │ 0       │ 0     │ 1       │ 0           │
│ https://source.developers.google.com/p/test/r/staging//@main    │ 1     │ 0      │ 0       │ 1     │ 0       │ 0           │
└─────────────────────────────────────────────────────────────────┴───────┴────────┴─────────┴───────┴─────────┴─────────────┘

Cada fila del resultado describió el repositorio y su estado correspondiente en los clústeres:

  • TOTAL es la cantidad de clústeres a la que se ajusta el repositorio.
  • SYNCED es la cantidad de clústeres en los que este repositorio se sincroniza correctamente.
  • PENDING es la cantidad de clústeres en los que este repositorio está pendiente de sincronización.
  • ERROR es la cantidad de clústeres en la que este repositorio experimenta algún error durante la sincronización.
  • STALLED es la cantidad de clústeres en los que se detiene la implementación que sincroniza este repositorio.
  • RECONCILING es el número de clústeres en el que se concilia la implementación que sincroniza este repositorio.

Enumera los repositorios con el estado ERROR

También puedes enumerar los repositorios con un estado específico mediante la marca --status. Los valores admitidos son sync, pending, error, stalled y reconciling. Por ejemplo, ejecuta el siguiente comando para enumerar los repositorios que tienen errores:

gcloud alpha anthos config sync repo list --status=error

El resultado es similar a este:

┌─────────────────────────────────────────────────────────────────┬───────┬────────┬─────────┬───────┬─────────┬─────────────┐
│                       SOURCE                                    │ TOTAL │ SYNCED │ PENDING │ ERROR │ STALLED │ RECONCILING │
├─────────────────────────────────────────────────────────────────┼───────┼────────┼─────────┼───────┼─────────┼─────────────┤
│ https://source.developers.google.com/p/test/r/staging//@main    │ 1     │ 0      │ 0       │ 1     │ 0       │ 0           │
└─────────────────────────────────────────────────────────────────┴───────┴────────┴─────────┴───────┴─────────┴─────────────┘

Describe un repositorio

Usa el comando describe para ver los detalles sobre el estado de tu repositorio:

   gcloud alpha anthos config sync repo describe \
     --source URL

Reemplaza URL por la URL del resultado del comando de lista que se describió en la sección anterior.

También puedes usar --namespace y --name para especificar el repositorio que deseas describir.

   gcloud alpha anthos config sync repo describe \
     --namespace config-management-system --name root-sync

De forma predeterminada, imprime el estado del repositorio y cualquier recurso administrado que se haya aplicado, pero que no se haya conciliado.

   [
     {
       "clusters": [
         "cluster-1",
         "cluster-2",
       ],
       "commit": "32293c90a63efba3121c7648048fcd3e85043a34",
       "errors": [],
       "source": "https://source.developers.google.com/p/test/r/test//@main",
       "status": "SYNCED"
     }
   ]

También puedes usar la marca --managed-resources para controlar los recursos administrados que deseas ver. Los valores admitidos son all, current, inprogress, notfound, failed (predeterminado) o unknown. Puedes usar el siguiente comando para ver todos los recursos administrados:

   gcloud alpha anthos config sync repo describe \
     --namespace config-management-system --name root-sync \
     --managed-resources all

El resultado es similar a este:

   [
     {
       "clusters": [
         "cluster-1",
         "cluster-2",
       ],
       "commit": "32293c90a63efba3121c7648048fcd3e85043a34",
       "errors": [],
       "source": "https://source.developers.google.com/p/test/r/test//@main",
       "status": "SYNCED"
     }
   ]
   ┌────────────────────────────────────────────────────────────────┐
   │                       managed_resources                        │
   ├───────┬───────────┬─────────┬───────────┬─────────┬────────────┤
   │ GROUP │    KIND   │   NAME  │ NAMESPACE │  STATUS │ CONDITIONS │
   ├───────┼───────────┼─────────┼───────────┼─────────┼────────────┤
   │       │ Namespace │ default │           │ Current │            │
   │       │ ConfigMap │ foo     │ default   │ Current │            │
   └───────┴───────────┴─────────┴───────────┴─────────┴────────────┘