Monitorar objetos RootSync e RepoSync

Esta página mostra maneiras diferentes de monitorar seus objetos RootSync e RepoSync.

Ver registros

Esta seção explica como visualizar os registros para os objetos RootSync e RepoSync. A visualização dos registros fornece informações sobre possíveis erros.

  • Para ver os registros do validador RootSync, execute o seguinte comando:

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

    Substitua CONTAINER_NAME por um dos seguintes valores:

    • git-sync: o contêiner git-sync extrai configurações do seu repositório Git para um diretório local em que o contêiner de reconciliação pode lê-los.

    • hydration-controller: o contêiner hydration-controller renderiza todas as configurações Helm ou Kustomize extraídas do seu repositório e, em seguida, salva as configurações renderizadas no volume compartilhado do contêiner reconciler. processo.

    • otel-agent: o contêiner otel-agent é um agente do OpenTelemetry para recuperar e exportar métricas do Config Sync.

    • reconciler: o contêiner reconciler aplica essas configurações ao cluster.

  • Para ver os registros do validador do RepoSync, execute o seguinte comando:

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

    Substitua:

    • NAMESPACE: o namespace em que você criou seu repositório de namespace.
    • CONTAINER_NAME: git-sync, hydration-controller, otel-agent ou reconciler.

Ver confirmações sincronizadas

Verifique qual confirmação está sincronizada com o cluster.

  • Para ver as confirmações sincronizadas do RootSync, execute o seguinte comando:

    kubectl get rootsync root-sync -n config-management-system
    
  • Para ver as confirmações sincronizadas do RepoSync, execute o seguinte comando:

    kubectl get reposync repo-sync -n NAMESPACE
    

    Substitua NAMESPACE pelo namespace em que você criou seu repositório de namespace.

A saída desses comandos mostra o valor da confirmação de origem e da confirmação sincronizada. Por exemplo, se você executar o comando para o RepoSync, verá uma saída semelhante a esta:

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

O valor na coluna RENDERINGCOMMIT é a confirmação processada pelo hydration-controller. Se nenhuma renderização for necessária, o valor será igual ao da coluna SOURCECOMMIT. O valor na coluna SOURCECOMMIT é a confirmação do repositório Git que precisa ser sincronizada com o cluster. O valor na coluna SYNCCOMMIT é a confirmação implantada no cluster. Se os dois valores nas colunas SOURCECOMMIT e SYNCCOMMIT forem os mesmos, a confirmação esperada foi implantada no cluster.

Ver detalhes do objeto

Para visualizar detalhes dos objetos RootSync e RepoSync, use kubectl describe. Esse comando pode fornecer mais informações sobre possíveis erros.

  • Para visualizar os detalhes do objeto RootSync, execute o seguinte comando:

    kubectl describe rootsync root-sync -n config-management-system
    
  • Para ver os detalhes do objeto do RepoSync, execute o seguinte comando:

    kubectl describe reposync repo-sync -n NAMESPACE
    

    Substitua NAMESPACE pelo namespace em que você criou seu repositório de namespace.

Ver se um recurso está pronto

Para saber se os recursos sincronizados com o cluster estão prontos, visualize o status da reconciliação. Por exemplo, a visualização do status de reconciliação pode mostrar se uma implantação sincronizada está pronta para veicular o tráfego.

Para um repositório Git sincronizado com o cluster, o status de reconciliação de todos os recursos é agregado a um recurso denominado ResourceGroup. Para cada objeto RootSync ou RepoSync, um ResourceGroup é gerado para capturar o conjunto de recursos aplicados ao cluster e agregar os status deles.

  • Para visualizar o status de reconciliação do objeto RootSync, execute o seguinte comando:

    kubectl get resourcegroup.kpt.dev root-sync -n config-management-system -o yaml
    
  • Para ver o status de reconciliação do objeto do RepoSync, execute o seguinte comando:

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

    Substitua NAMESPACE pelo namespace em que você criou seu repositório de namespace.

Na saída, você verá todos os status de recursos de ResourceGroup. Por exemplo, a saída a seguir mostra que uma implantação chamada nginx-deployment está pronta:

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

A seguir