Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Visualizar o status do Config Sync em vários clusters

Se você instalar e configurar o Config Sync em vários clusters registrados em um projeto, use gcloud alpha anthos config sync repo para listar o status do repositório que está sendo sincronizado entre clusters e depurar problemas com o Config Sync. Em comparação com nomos status, o status de grupos gcloud alpha anthos config sync repo é calculado por repositório, enquanto o comando nomos status agrupa o status por cluster.

Antes de começar

Antes de usar gcloud alpha anthos config sync repo, conclua os seguintes passos:

  1. Atualize os componentes da Google Cloud CLI executando o comando a seguir:

    gcloud components update
    
  2. Registre os clusters se ainda não tiver feito isso. Se você instalou e configurou o Config Sync por meio do console, pule esta etapa.

  3. Os administradores da plataforma precisam configurar o gateway de conexão para o cluster registrado, caso ele não seja um cluster do GKE.

  4. Defina o projeto executando o seguinte comando:

    gcloud config set project PROJECT_ID
    

    Substitua PROJECT_ID pelo ID do projeto em que o Config Sync está configurado e em execução.

Uso básico

Listar todos os repositórios

   gcloud alpha anthos config sync repo list

Esse comando lista todo o status dos repositórios Git que estão sincronizados com os clusters registrados no projeto atual. A saída será assim:

┌─────────────────────────────────────────────────────────────────┬───────┬────────┬─────────┬───────┬─────────┬─────────────┐
│                       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 linha da saída descreveu o repo e o status correspondente nos clusters:

  • TOTAL é o número de clusters em que o repositório está inscrito.
  • SYNCED é o número de clusters em que esse repositório é sincronizado.
  • PENDING é o número de clusters em que esse repositório está pendente para sincronização.
  • ERROR é o número de clusters em que esse repositório encontra algum erro durante a sincronização.
  • STALLED é o número de clusters em que a implantação sincroniza esse repositório.
  • RECONCILING é o número de clusters em que a implantação que sincroniza esse repositório está sendo reconciliada.

Listar repositórios com status ERROR

Também é possível listar os repositórios com um status específico usando a sinalização --status. Os valores aceitos são synced, pendente, erro, parado e reconciliado. Por exemplo, liste os repositórios que têm erros executando o seguinte comando:

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

A saída será assim:

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

Descrever um repositório

Use o comando de descrição para ver detalhes sobre o status do repositório:

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

Substitua URL pelo URL da resposta ao comando de lista descrito na seção anterior.

Também é possível usar --namespace e --name para especificar o repo que você quer descrever.

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

Por padrão, ele imprime o status do repositório e todos os recursos gerenciados que foram aplicados, mas a reconciliação falhou.

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

Também é possível usar a sinalização --managed-resources para controlar os recursos gerenciados que você quer visualizar. Os valores aceitos são all, current, inprogress, notfound, failed } (padrão) ou unknown. Use o seguinte comando para ver todos os recursos gerenciados:

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

A saída será assim:

   [
     {
       "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 │            │
   └───────┴───────────┴─────────┴───────────┴─────────┴────────────┘