ArgoCD¶
Couche : Plateforme GitOps · Où : pods du cluster (namespace argocd, pool platform) · Version : chart argo-cd 10.10.5
À quoi elle sert ici et pourquoi ce choix¶
Après le bootstrap, plus rien n'est appliqué à la main : ArgoCD réconcilie le cluster avec gitops/. Une Application root synchronise le socle
gitops/platform ; un ApplicationSet apps crée une Application par dossier de gitops/apps/*. ArgoCD gère aussi sa propre configuration et les
objets Cluster API du cluster lui-même. Décision : ADR 7.
Où elle tourne et comment elle est déployée¶
Installé par bootstrap/scripts/gitops.sh (Helm, mêmes valeurs que l'Application), qui crée aussi le Secret sops-age (clé du cluster), le Secret du dépôt
(clé de déploiement) et l'Application root. Il s'auto-gère ensuite (sync-wave -5). L'ordre d'installation des composants est porté par les sync-wave
(voir Bootstrap).
Version épinglée¶
Chart argo-cd 10.10.5 dans gitops/platform/argocd/application.yaml ; init container alpine:3.24.2@sha256:... pour ksops (gitops/platform/argocd/values.yaml).
Fichiers de configuration dans le dépôt¶
gitops/bootstrap/root.yaml: AppProjectsplatform,apps,cluster, Applicationroot, ApplicationSetapps.gitops/platform/argocd/values.yamletapplication.yaml.gitops/platform/kustomization.yaml: liste des Applications du socle.
Interactions avec les autres briques¶
- Lit le dépôt Git par SSH sur le port 443 (
git.sshdu contrat =ssh://git@ssh.github.com:443/..., les zones n'ayant d'egress qu'en 80/443 ; clé de déploiement ; unrepoURLHTTPS ne correspondrait pas au Secretrepo-pad: « authentication required ») et déchiffre via ksops. - Egress : le namespace
argocdest en default-deny (gitops/platform/namespaces/resources/argocd.yaml) ; seul le repo-server sort, vers l'Internet public en 443 (Git, dépôts Helm/OCI), par la CiliumNetworkPolicyargocd-repo-server-egress. Ce fichier est appliqué par le bootstrap avant ArgoCD : sans cette règle, ArgoCD se coupe lui-même de Git en appliquant l'Applicationnamespaceset ne peut plus se réparer. - Authentifie par Authentik (client
pad-argocd, seul le groupeinfra-adminsest admin ;ctf-admins, qui n'administre qu'un événement, n'a aucun accès). - Applique tous les composants : Cilium, Kyverno, cert-manager, les applications CTF...
Sécurité¶
- SSO uniquement : le compte local
adminest désactivé dès le bootstrap (secours :argocd login --coreavec les droitskubectlde l'opérateur) ; politique RBAC par défaut vide, aucun droit horsinfra-admins. - Une PR qui touche le RBAC,
gitops/bootstrap/root.yamlou unClusterRoleBindingse relit comme un changement de privilèges ; protéger la branchemain(procédure). exec.enabled: false; suivi des ressources par annotation (évite la capture des objets enfants Cluster API).- Namespace en PSS
restricted;server.insecurecar le TLS est terminé par Traefik. - AppProjects distincts : le projet
appsne peut créer que des namespaces explicitement listés.
Supervision¶
Alertes ArgoCDOutOfSync, ArgoCDAppUnhealthy, ArgoCDSyncFailed : ArgoCD. Dashboard pad-platform.
Opérations courantes¶
export KUBECONFIG="$PWD/.state/kubeconfig"
argocd app list # ou : kubectl -n argocd get applications
argocd app sync <application>
kubectl -n argocd get applications -o wide
Pièges connus¶
- Sans le Secret
sops-age, ksops échoue explicitement (le volume estoptional) : vérifier qu'il existe aprèsbootstrap:gitops. - Ne pas faire de
kubectl applyhorsbootstrap/: la prochaine synchronisation annule la modification. - Les Applications de providers CAPI et du
Clusterportent des garde-fous (Prune=false) : ne pas les retirer. - OutOfSync permanent alors que tout est sain : avec
ServerSideApply, ArgoCD possède en bloc les listes et structures atomiques ; une valeur par défaut qu'y ajoute l'API server ou un webhook apparaît comme un écart. Corrigé soit dans le manifeste (valeur explicite :generate: falsede MariaDB,namespacedeinfrastructureTemplate, label des CRD kyverno-api, pas dedirectory: { recurse: false }), soit parignoreDifferencesciblé (volumeClaimTemplatesdes StatefulSet garage et zot, défauts desspec.rulesdes ClusterPolicy).