Um hub Argo CD, 34 clusters: lições de um control plane GitOps em escala

O relato de Nitish Mane descreve um hub Argo CD único que gerenciava 34 clusters em 22 contas AWS e um tenancy da Oracle Cloud, em cinco regiões e três continentes. Um repositório com 174 Helm charts gerava 1.214 objetos Application. O hub concentrava o registro dos clusters, a identidade do controlador Cluster API e três ApplicationSets: baseline por cluster (app-of-apps), serviços compartilhados de plataforma e as definições Cluster API dos próprios clusters.

O desenho central é o contrato por cluster: um arquivo com cerca de vinte chaves (identidade, fronteira da conta, região, ambiente, acesso à API, DNS e certificados delegados, opt-outs) do qual se derivam Applications, nomes de roles IAM, identidade Cluster API, delegação de DNS e tags de custo. Adicionar um cluster a uma frota era mudar um label, e adicionar um componente era uma linha em uma lista, com matrix generators fazendo o fan-out. No CI, tudo é renderizado a cada merge request e o diff dos manifests vai para a revisão. Para a bad day, os ApplicationSets preservam recursos na exclusão e os objetos Cluster carregam no-prune. Na AWS o hub não guardava segredos cross-account de longa duração. Na Oracle Cloud isso não foi possível, e o registro ainda lia uma credencial de um vault.

Os números têm ressalvas do próprio autor. O drift fora de banda foi de 24,3 incidentes por mês para 0,9, mas com métodos de contagem diferentes, então não é uma redução limpa de 96%. O onboarding caiu de 4,0 dias (oito clusters, reconstruído de tickets) para 1,7 hora (onze clusters, de merge até o primeiro sync), com a remoção de aprovações manuais no cutover e amostras pequenas.

A cobertura anterior tratava o problema como alerta. Em 27 de fevereiro de 2026, o CEVIU noticiou "Como escalar GitOps em empresas: Do cluster único à gestão de frotas", que apontava gargalos de performance, config sprawl e atrito cultural acima de 20 a 50 clusters (o chamado Argo Ceiling). Em 4 de março de 2026, "Arquitetura, Padrões e Anti-Padrões de GitOps" citava a expansão descontrolada de multi-cluster e o drift como dores das equipes de plataforma. O relato atual traz um caso concreto de 34 clusters num único hub, com as práticas que o autor diz terem contido esses problemas.

Em 6 de março de 2026, o CEVIU noticiou "Argo CD 3.3 traz exclusões mais seguras e otimizações para GitOps", com PreDelete hooks para exclusões seguras. O texto atual não menciona essa versão. Ele resolve o risco de exclusão em cascata com configurações de preservação e no-prune.

Para quem opera Argo CD em escala, a leitura é que o ganho veio menos da ferramenta e mais da disciplina: contrato único por cluster, render completo no CI e defaults restritivos contra exclusão. Se você tem muitos charts, o diff de manifests no merge request provavelmente protege mais do que revisar templates. E o ponto do segundo provedor serve de aviso: modelos de credencial sem segredo guardado nem sempre se repetem fora da AWS.