GitOps con ArgoCD: automazione della distribuzione dichiarativa

GitOps è la pratica di gestire l'infrastruttura e le distribuzioni dai repository Git, trattando il repository come l'unica fonte di verità. ArgoCD è lo strumento principale per applicare questo modello ai cluster Kubernetes], offrendo sincronizzazione automatica, visualizzazione delle differenze e controllo completo.

Perché adottare GitOps?

Coerenza, lo stato desiderato è versione in Git; qualsiasi deviazione può essere invertita.
Audit, ogni modifica ha una cronologia di commit, autore e revisione.
Rollback istantaneo, ripristina semplicemente il commit e ArgoCD riconcilia il cluster.
Collaborazione, le richieste pull consentono la revisione delle modifiche alle infrastrutture prima dell'applicazione.

Architettura di base di ArgoCD

Repository Server, memorizza i manifest (YAML, Helm, Kustomize).
Controller dell'applicazione, confronta lo stato del cluster con il manifest Git e applica le differenze.
API Server, espone l'interfaccia utente e API REST per la gestione.
Dex / SSO, integrazione con provider di identità (GitHub, Okta).

Il flusso di lavoro è semplice: ArgoCD Controller crea git pull dal repository, applica i manifest al cluster Kubernetes tramite kubectl apply e legge continuamente lo stato del cluster per confrontarlo con lo stato desiderato. Gli utenti interagiscono con il controller tramite l'interfaccia utente o l'API. Pertanto, il repository rimane l'unica fonte di verità e il cluster viene mantenuto automaticamente sincronizzato.

Configurazione del repository

La struttura consigliata separa un livello base/, con risorse condivise come namespace.yaml e rbac.yaml, da un livello apps/, in cui ciascuna applicazione (ad esempio, frontend e backend) ha i propri kustomization.yaml e deployment.yaml. Kustomize ti consente di sovrascrivere le configurazioni per ambiente (sviluppo, staging, produzione) senza duplicare i manifest.

Manifesto dell'applicazione ArgoCD (YAML), 7 righe

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: my-app
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/yourorg/infra.git
    targetRevision: HEAD
    path: apps/frontend
  destination:
    server: https://kubernetes.default.svc
    namespace: production
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

syncPolicy.automated consente la sincronizzazione automatica e la pulizia delle risorse obsolete.

Strategie di sincronizzazione

Automatico, ideale per ambienti di allestimento in cui la velocità è fondamentale.
Manuale (guidato dalle PR), per la produzione, in cui ogni modifica viene rivista prima di essere applicata.
Hook, script eseguiti prima o dopo la sincronizzazione (es.: migrazioni DB).

Osservabilità e auditing

UI, mostra la differenza tra lo stato desiderato e quello reale, con il pulsante "Sincronizza".
Webhook, notifica a Slack/Teams eventi di sincronizzazione o errore.
Metriche, espone le metriche di Prometheus (argocd_app_sync_total, argocd_app_health_status).
Log, centralizza con Loki o Elasticsearch per tenere traccia delle azioni.

##Sicurezza

RBAC, definire i ruoli (admin, read-only, dev) nello spazio dei nomi argocd.
SSO, integrazione con OAuth2/OIDC (GitHub, Google, Okta).
TLS mutuo, tra ArgoCD e il server API Kubernetes.
Politica di protezione del ramo, richiede revisioni e controlli dello stato prima della fusione.

Lista di controllo per l'implementazione

Crea repository Git con struttura base/ e apps/.
Installa ArgoCD (kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml).
Configura SSO/Dex per autenticazione aziendale.
Definire i CRD dell'applicazione per ciascun microservizio.
Abilita syncPolicy.automated negli ambienti di prova.
Configura gli avvisi in Prometheus/Alertmanager per gli errori di sincronizzazione.
Flusso PR documento → Unisci → Sincronizza.

Conclusione

GitOps con ArgoCD offre controllo della versione, udibilità e automazione per la distribuzione delle applicazioni Kubernetes. Seguendo le best practice per la struttura, la sicurezza e l'osservabilità del repository, il tuo team può implementare le modifiche in modo rapido e sicuro.

Utilizzi già ArgoCD? Condividi i tuoi suggerimenti e le tue sfide nei commenti!