Cloud Custodian : erreur « custodian not found »

By Mirko Peters · 2026-04-26 · Updated 2026-07-18

Corrigez l’erreur « custodian not found » de Cloud Custodian grâce à des étapes de dépannage concrètes portant sur la configuration, l’installation, les fichiers de stratégies et l’exécution.

Automatically translated with AI from the original post. Read the English original

Se heurter à une erreur « custodian not found » est frustrant, surtout quand on cherche simplement à automatiser une gouvernance cloud élémentaire. Cloud Custodian est un outil Python puissant pour gérer et appliquer des stratégies dans vos environnements cloud, notamment Microsoft Azure, AWS et d’autres. Mais un incident d’installation, une dépendance manquante ou une simple coquille peuvent vous bloquer complètement.

Ce guide vous explique comment corriger les erreurs « custodian not found », que vous travailliez dans votre terminal local, dans un pipeline CI/CD ou même dans un conteneur. Et si vous êtes arrivé ici par erreur en cherchant le Custodian de Remnant 2, pas d’inquiétude : nous vous aiderons à faire la différence et à retrouver le bon chemin.

Que vous débutiez ou que vous exploitiez des environnements Microsoft complexes soumis à des exigences de gouvernance strictes, cet article vous accompagne avec des étapes de dépannage détaillées, des bonnes pratiques et des liens vers des stratégies de gouvernance, comme celle-ci consacrée à la gouvernance d’entreprise Azure. Résolvons ensemble ces problèmes de « not found » et gardons votre cloud sous contrôle.

Comprendre les erreurs « Custodian Not Found » dans la configuration de Cloud Custodian

Voyons ce qui se passe réellement lorsque le message « custodian not found » apparaît dans votre terminal. Neuf fois sur dix, ce message signifie quelque chose de simple : votre système ne parvient pas à localiser l’exécutable Custodian. Cela tient souvent au fait que l’outil n’est pas installé, que l’installation ne s’est pas faite à l’emplacement attendu, ou que votre ligne de commande ne cherche pas au bon endroit.

Parmi les causes fréquentes de cette erreur figurent des prérequis manquants, des versions de Python incompatibles, un environnement virtuel non activé ou une variable PATH mal configurée. Parfois, des problèmes d’autorisations ou des stratégies de sécurité, comme AppLocker ou SELinux, peuvent bloquer l’outil sans avertissement évident, ce qui donne l’impression que Custodian a disparu sans laisser de trace.

Si vous travaillez sur la gouvernance cloud, en particulier dans des environnements Microsoft ou hybrides, vous avez besoin d’outils d’automatisation fiables. Une erreur « not found » est souvent le signe que les fondations techniques méritent attention, qu’il s’agisse de la gestion des dépendances, de la gestion des environnements virtuels ou de l’intégration correcte de Custodian dans vos déploiements. Vous pourriez aussi rencontrer des difficultés avec les runners CI/CD ou lors de l’empaquetage de Custodian dans des conteneurs Docker destinés à Kubernetes.

Avant de réinstaller ou de revoir entièrement votre configuration, il est utile de comprendre ce qui déclenche ces erreurs et de vous familiariser avec les outils en jeu, comme Python 3, pip, UV et les environnements virtuels. Vous trouverez ci-après les instructions pas à pas pour une installation correcte, ainsi que des conseils pour préparer votre environnement afin que tout fonctionne dès que vous appelez la commande « custodian ».

Installer Custodian avec UV et pip : étape par étape

1. Vérifier l’installation de Python 3
2. Ouvrez votre terminal et vérifiez si Python 3 est installé en exécutant :

• python3 --version ou python --version

1. Si vous ne voyez pas une version 3.x.x, installez d’abord Python 3. Ne sautez pas cette étape, sans quoi rien d’autre ne fonctionnera.
2. Installer UV (installateur Python de nouvelle génération)
3. UV est le successeur de pip, plus rapide et plus fiable pour gérer les dépendances. Pour installer UV :

• Avec pip : pip install uv
• Vous pouvez également télécharger les binaires précompilés depuis le projet GitHub UV.

1. Créer et activer un environnement virtuel (recommandé)
2. Un environnement virtuel regroupe vos dépendances Python dans un dossier ordonné et sans conflit. Exécutez :

• python3 -m venv cenv
• Activation sous macOS/Linux : source cenv/bin/activate
• Activation sous Windows : cenv\Scripts\activate

1. Installer Cloud Custodian
2. Une fois votre environnement prêt, exécutez :

• uv pip install c7n ou, si vous utilisez pip classique, pip install c7n

1. Cette commande installe Cloud Custodian ainsi que toutes les dépendances requises. Attendez le message indiquant que l’installation s’est terminée sans erreur.
2. Vérifier l’installation
3. Dans votre terminal, saisissez :

• custodian version ou custodian --help
• Si la commande affiche la version ou l’aide, l’installation est opérationnelle. Si la commande reste introuvable, vérifiez l’activation de votre environnement virtuel ou votre variable PATH.

1. Éviter les pièges courants
2. Sous Windows, assurez-vous que le dossier Scripts figure dans votre PATH lorsque l’environnement virtuel est activé. Sous macOS/Linux, restez dans le répertoire où vous avez activé l’environnement.

Remarque : si « custodian » n’est toujours pas reconnu, essayez d’exécuter python -m custodian pour vérifier que le module est bien installé mais absent du PATH. Cela permet de diagnostiquer les problèmes de chemin des binaires sans tout réinstaller.

Configurer Python 3 et les environnements virtuels pour accéder à Custodian

1. Installer Python 3
2. Rendez-vous sur le site officiel de Python pour télécharger le dernier programme d’installation de Python 3.x adapté à votre système d’exploitation, ou utilisez un gestionnaire de paquets (Homebrew, apt ou Microsoft Store). Assurez-vous que l’emplacement d’installation est ajouté à votre PATH.
3. Vérifier que Python figure dans votre PATH
4. Ouvrez une nouvelle fenêtre de terminal et saisissez :

• python3 --version (macOS/Linux)
• python --version (Windows, ou si python3 est introuvable)

1. Si cette commande renvoie une erreur, vérifiez que Python est bien installé et reconnu dans le PATH de votre système.
2. Créer un environnement virtuel
3. Utilisez le module venv intégré pour isoler votre environnement :

• python3 -m venv myenv

1. Cette commande crée un dossier nommé « myenv » qui contient les dépendances propres à votre projet.
2. Activer l’environnement virtuel

• Sous macOS/Linux : source myenv/bin/activate
• Sous Windows : myenv\Scripts\activate

1. L’invite de votre terminal doit changer et indiquer que vous êtes dans l’environnement Python.
2. Vérifier l’activation et installer Custodian
3. Une fois l’environnement activé, installez Cloud Custodian avec pip install c7n ou uv pip install c7n. Activez toujours l’environnement avant de travailler avec Custodian, sans quoi vous risquez d’installer ou d’exécuter Custodian au mauvais endroit.
4. Éviter les confusions d’environnement
5. Si vous utilisez Conda, activez l’environnement Conda avant l’installation. Pour vérifier l’emplacement depuis lequel « custodian » sera exécuté, utilisez which custodian (macOS/Linux) ou where custodian (Windows), ou lancez python -m custodian pour un autre test rapide.

Une configuration correcte de Python 3 et des environnements virtuels est la base qui garantit le bon fonctionnement de « custodian » à chaque exécution. Omettre ces étapes ou les mélanger est la principale cause des erreurs « introuvable » si agaçantes, même lorsque vous pensez que tout est correctement installé.

Installer les prérequis sous macOS, Windows et Linux

• macOSInstallez Homebrew si ce n’est pas déjà fait : /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• Utilisez Homebrew pour installer Python 3 : brew install python
• Vérifiez l’installation : python3 --version
• Installez virtualenv (facultatif mais utile) : pip3 install virtualenv
• WindowsTéléchargez Python depuis le site officiel ou installez-le via le Microsoft Store pour une configuration plus simple.
• Veillez à cocher « Add Python to PATH » pendant l’installation : ne décochez surtout pas cette option.
• Vérifiez l’installation : python --version
• Installez virtualenv si nécessaire : pip install virtualenv
• Facultatif : utilisez Chocolatey pour la gestion des paquets : choco install python
• Linux (Ubuntu/Debian/Fedora/RedHat/CentOS)Ubuntu/Debian : sudo apt update && sudo apt install python3 python3-venv python3-pip
• Fedora/RedHat : sudo dnf install python3 python3-venv python3-pip
• CentOS : sudo yum install python3 python3-venv python3-pip
• Vérifiez la version : python3 --version

Une fois Python installé, vérifiez les versions et assurez-vous que pip est disponible. Vous pouvez installer UV pour une gestion plus rapide des dépendances avec pip install uv, si vous le souhaitez. Ces bases vous épargneront bien des difficultés, en particulier dans les environnements d’entreprise ou réglementés soumis à des exigences strictes. Une fois la configuration terminée, vous êtes prêt à passer à l’installation de Custodian proprement dite.

Installation pour développeurs : configuration technique et clonage du dépôt

Si vous souhaitez vous lancer en tant que développeur de Cloud Custodian ou exécuter la version la plus récente, cette section vous présente la configuration appropriée. Contrairement à une simple installation, vous allez récupérer le code source, ce qui vous donne un accès complet pour contribuer, exécuter les tests ou modifier directement les stratégies.

Travailler à partir des sources implique de cloner le dépôt officiel de Cloud Custodian et de manipuler votre environnement avec un peu plus de précaution. Vous serez parfois confronté à des éléments techniques, comme la gestion des identifiants utilisateur uniques (UID/UUID) ou des autorisations des utilisateurs. Il est important d’isoler votre environnement de développement afin d’éviter que des problèmes accidentels n’affectent votre machine principale.

Cette présentation expose le raisonnement et le processus de base. Vous trouverez ensuite des instructions claires pour activer l’environnement du dépôt, exécuter la suite de tests et vérifier que Custodian fonctionne localement comme prévu. Que vous contribuiez au code, que vous récupériez une branche de fonctionnalité ou que vous validiez une correction de bogue, les étapes suivantes vous indiquent comment démarrer sereinement, sans complications ni points en suspens.

Exécuter les tests et Custodian dans l’environnement UV

1. Activer votre environnement de développement
2. Accédez au répertoire du dépôt et activez votre environnement virtuel avec la commande source venv/bin/activate (Linux/macOS) ou venv\Scripts\activate (Windows).
3. Installer les dépendances requises
4. Utilisez UV pour installer les dépendances de test : uv pip install -e .[dev,test] dans le dossier Cloud Custodian.
5. Exécuter la suite de tests
6. La commande uv run pytest exécute l’ensemble des tests automatisés et signale les échecs ou problèmes éventuels. Elle permet de vérifier que votre installation de développement fonctionne correctement.
7. Exécuter Custodian localement
8. Exécutez uv run custodian version ou uv run custodian --help pour vérifier que Custodian est opérationnel, que l’interface s’affiche comme prévu et que l’ensemble fonctionne correctement.

Si vous rencontrez des erreurs inhabituelles ou des commandes introuvables, vérifiez l’activation de votre environnement virtuel et l’étape d’installation des paquets. La plupart des problèmes se résolvent en répétant ces commandes dans le bon répertoire.

Résoudre les problèmes de chemin et de binaire lorsque Custodian est introuvable

1. Vérifier si Custodian figure dans votre PATH
2. Exécutez which custodian (macOS/Linux) ou where custodian (Windows) pour savoir si le binaire est accessible. Si rien ne s’affiche, l’outil ne figure pas dans votre PATH.
3. Activer le bon environnement virtuel
4. Assurez-vous d’avoir activé l’environnement dans lequel Custodian a été installé. L’invite de commandes doit normalement changer pour indiquer que vous êtes dans cet environnement (par exemple, (cenv)).
5. Exécuter directement le module à des fins de diagnostic
6. Essayez python -m custodian. Si cette commande fonctionne alors que « custodian » ne fonctionne pas, cela indique que le répertoire de vos scripts n’est pas inclus dans le PATH système.
7. Modifier votre variable PATH
8. Sous macOS/Linux : vérifiez ~/.bashrc, ~/.zshrc ou ~/.profile, et ajoutez si nécessaire l’emplacement de vos scripts Python (généralement ~/.local/bin ou le répertoire bin de votre environnement virtuel).
9. Sous Windows : vérifiez que le dossier Scripts de votre environnement virtuel est ajouté au PATH système si vous exécutez Custodian en dehors de l’environnement activé.
10. Surveiller le contexte utilisateur et les autorisations
11. L’exécution avec sudo ou sous un autre utilisateur peut modifier le contenu de votre PATH. Les stratégies de sécurité ou les shells restreints peuvent bloquer l’exécution des binaires, voire masquer les scripts installés (les outils d’entreprise comme AppLocker ou SELinux sont particulièrement susceptibles de provoquer ce comportement).
12. Vérifier dans les environnements CI/CD et les conteneurs
13. Dans GitHub Actions, GitLab CI ou Jenkins, assurez-vous que le binaire « custodian » est installé dans le runner ou l’image. Dans Docker, ajoutez l’installation à votre Dockerfile et définissez correctement ENTRYPOINT ou PATH afin que « custodian » soit disponible au démarrage du conteneur.

En suivant ces étapes, vous pouvez rapidement déterminer s’il s’agit d’un problème de chemin, d’un défaut d’autorisations ou d’une installation manquante à l’origine du message « introuvable ». Le diagnostic avec which, python -m et la compréhension des environnements utilisateur sont essentiels pour disposer d’une installation de Custodian fonctionnelle sur toutes les plateformes.

Éviter la confusion avec le wiki de Custodian Remnant : Cloud Custodian ou Remnant 2

Il faut lever toute ambiguïté : Cloud Custodian est un outil de gouvernance cloud qui automatise les contrôles de sécurité et de conformité. Il n’a aucun rapport avec « The Custodian », un personnage que vous rencontrez dans le jeu d’action Remnant 2. Si vous cherchez des conseils de quête RPG ou des stratégies contre les boss, consultez plutôt les wikis de jeux, et non ce guide technique.

La confusion dans les recherches vient du fait que le mot « custodian » apparaît à la fois dans les milieux technologiques et dans ceux du jeu vidéo. Lorsque vous dépannez des erreurs d’automatisation cloud, recherchez des indices contextuels comme « Python », « pip install » ou « command not found », qui confirment que vous êtes au bon endroit pour des solutions informatiques et non pour une solution de jeu. Restez sur ce guide si vous recherchez une application concrète des stratégies cloud, en particulier pour Microsoft et les environnements multicloud.

À écouter également

Si vous explorez Cloud Custodian custodian not found, ces épisodes apportent un contexte pratique pour une adoption sécurisée de Microsoft 365, la protection des données, la gouvernance et la gestion des risques liés à l’IA.

• Microsoft Purview – Simply Explained — Découvrez comment la classification, la rétention, la conformité et la protection s’intègrent dans un même modèle de gouvernance des données Microsoft.
• Microsoft Defender XDR – Simply Explained — Reliez les contrôles de protection des données à la détection, à l’investigation et à la réponse aux incidents.
• Conditional Access – Simply Explained — Comprenez comment les signaux d’identité et de risque apportent du contexte aux décisions d’accès.
• Microsoft AI Agent Harness – Simply Explained — Explorez les contrôles qui rendent l’automatisation par IA plus fiable, observable et sûre.

Ces épisodes vous aident à transformer les concepts de l’article en décisions concrètes de conception et de déploiement.