Une Application Synced et Healthy affiche un avertissement :
Application has 7 orphaned resources
Rien n’est cassé, rien n’est à corriger, et la ligne restera là. C’est le comportement normal de la détection des ressources orphelines, et la première chose à comprendre est ce qu’elle compte exactement — parce que ce n’est presque jamais ce qu’on croit.
Ce que la fonctionnalité regarde
Une ressource orpheline, dans le vocabulaire d’Argo CD, est une ressource namespacée de premier niveau qui n’appartient à aucune Application. Chacun des trois termes retire quelque chose du périmètre.
Namespacée : les objets à portée cluster ne sont jamais candidats. Un ClusterRole, un ValidatingWebhookConfiguration, une StorageClass posés à la main ne seront jamais signalés, quel que soit le réglage.
De premier niveau : le contrôleur ne retient que les objets sans ownerReferences. Un ReplicaSet créé par un Deployment orphelin ne compte pas séparément ; on voit le parent, pas la descendance. Un Job créé par un CronJob non plus.
Qui n’appartient à aucune Application : le rattachement se fait par la méthode de suivi configurée dans l’instance — annotation argocd.argoproj.io/tracking-id par défaut, ou étiquette app.kubernetes.io/instance en mode label. C’est un point de fragilité concret : une ressource dont le marqueur de suivi a été écrasé par un autre outil — plusieurs charts Helm et opérateurs écrivent cette même étiquette — devient orpheline aux yeux d’Argo CD alors qu’elle est bien déclarée dans le dépôt.
Reste le périmètre le plus restrictif, et le moins documenté dans les têtes : le contrôleur ne balaie que le namespace de destination de l’Application. Pas le cluster, pas les autres namespaces où l’Application a déployé des objets. Une Application qui pousse dans trois namespaces ne fait l’inventaire que d’un seul.
L’activation se fait sur le projet, pas sur l’Application
Le réglage vit dans l’AppProject, et couvre donc toutes les Applications qui en dépendent.
apiVersion: argoproj.io/v1alpha1
kind: AppProject
spec:
orphanedResources:
warn: true
warn: true produit l’avertissement. warn: false active la détection sans l’avertissement : les orphelines restent visibles dans l’interface via le filtre Show Orphaned, mais aucune condition n’est posée sur l’Application. La documentation recommande explicitement de commencer par là, et c’est un bon conseil.
Un avertissement s’accompagne d’une condition de type OrphanedResourceWarning sur l’Application, et d’une métrique exportée par le contrôleur :
argocd_app_orphaned_resources_count
C’est cette métrique qui rend la fonctionnalité utile ailleurs que dans l’interface : elle donne un nombre par Application, donc une dérivée. Un plateau à sept n’apprend rien ; un passage de sept à quarante en une journée dit que quelque chose a créé des objets hors du dépôt.
Pourquoi c’est bruyant par défaut
Tout ce qui vit dans un namespace n’est pas censé venir de Git. Les opérateurs créent des objets pour leur propre compte — un gestionnaire de certificats qui matérialise un Secret, un contrôleur qui pose une ConfigMap de travail — et ces objets, n’appartenant à aucune Application, sont comptés comme orphelins.
Argo CD exclut d’office quatre familles, et la liste est courte :
- les ressources namespacées refusées par le projet — listées dans
namespaceResourceBlacklist, ou absentes d’unnamespaceResourceWhitelistrestrictif — au motif qu’elles relèvent de l’administration du cluster et pas de l’utilisateur du namespace ; - le
ServiceAccountnommédefault, et son jeton généré automatiquement ; - le
Servicenommékubernetesdans le namespacedefault; - la
ConfigMapkube-root-ca.crt, dans tous les namespaces.
Tout le reste se déclare à la main, sous forme de règles combinant groupe, type et nom :
spec:
orphanedResources:
ignore:
- kind: ConfigMap
name: orphaned-but-ignored-configmap
# The name accepts a glob pattern
- kind: Secret
name: '*.example.com'
Le nom accepte un motif glob, le groupe et le type aussi. Un kind ou un name vide vaut « tous ». C’est la porte de sortie du bruit : on écrit une règle par opérateur qui produit des objets, une fois, et l’avertissement redevient un signal.
Le coût, qui n’est pas nul
L’avertissement de la documentation mérite d’être pris au mot : activer la détection sur un projet dont les Applications visent un namespace peuplé de ressources non gérées — un namespace système, typiquement — a un impact mesurable sur l’instance Argo CD. Le contrôleur doit énumérer et suivre tout le contenu du namespace, pas seulement ce que le dépôt déclare, et cette information alimente le cache d’état vivant à chaque rafraîchissement.
C’est la raison pour laquelle ça s’active projet par projet, sur des projets dont les namespaces sont bien délimités, et pas globalement « parce que ça peut servir ».
Ce que ça ne dit pas
Quatre silences, et ce sont eux qui déterminent l’usage qu’on peut en faire.
Ça ne change rien au statut de synchronisation. Une Application avec cinquante orphelines reste Synced. La condition est un avertissement, pas un état de santé : elle ne bloque aucune synchronisation, ne déclenche aucune réconciliation, ne fait rien de plus qu’afficher un nombre.
Ça ne dit pas d’où vient l’objet. Une orpheline peut être un vestige d’une Application supprimée, un objet créé par un opérateur, un kubectl apply d’urgence jamais reporté dans le dépôt, ou une ressource parfaitement légitime dont le marqueur de suivi a été perdu. Le contrôleur ne distingue pas ces cas — c’est à la lecture de faire le tri.
Ça ne couvre pas ce qui est à portée cluster, c’est-à-dire exactement la catégorie d’objets qu’on pose à la main en urgence et qu’on oublie ensuite : rôles, webhooks, CustomResourceDefinition. La dérive la plus coûteuse est hors champ.
Ça ne remplace pas le pruning. Une orpheline n’est jamais supprimée automatiquement ; l’interface permet de la supprimer à la main, une par une. Ce qui disparaît tout seul, ce sont les ressources qu’une Application a cessé de déclarer, et seulement si prune est activé — deux mécanismes distincts qu’on confond facilement parce qu’ils traitent tous les deux d’objets « en trop ».
L’usage qui reste, une fois ces limites posées, est plus étroit que la promesse mais réel : sur des namespaces dédiés à une Application, avec une liste ignore tenue à jour, le nombre d’orphelines est un indicateur de discipline. Il ne mesure pas l’état du cluster, il mesure l’écart entre ce que le dépôt déclare et ce que quelqu’un a fini par créer autrement — la même question que pose le découpage en Applications à l’échelle, et que le reste de la chaîne CI/CD doit trancher en amont.