Politiques de suppression des hooks

Par défaut, une ressource de crochet reste dans le cluster après son exécution. Sans nettoyage, les anciens Jobs et Pods de migration s’accumulent à chaque version.

Vous contrôlez le nettoyage avec l’annotation helm.sh/hook-delete-policy. Elle indique précisément à Helm quand supprimer une ressource de crochet qu’il a créée.

Le choix le plus courant est hook-succeeded. Helm supprime la ressource de crochet juste après son exécution réussie, ce qui permet de garder l’espace de noms propre.

Avec hook-succeeded, un crochet qui échoue est volontairement conservé. Vous pouvez lire ses journaux pour comprendre pourquoi la migration a échoué avant de le supprimer manuellement. 🔍

La stratégie opposée est hook-failed. Helm supprime la ressource de crochet uniquement lorsqu’elle échoue, ce qui convient aux crochets que vous préférez ne pas laisser dans un état défaillant.

La troisième option est before-hook-creation. Helm supprime l’instance précédente juste avant de créer la nouvelle, évitant ainsi les conflits liés aux noms immuables.

Si vous ne définissez aucune stratégie, Helm utilise before-hook-creation par défaut. L’ancien crochet est supprimé juste avant que la prochaine exécution ne le recrée.

Les stratégies peuvent être combinées dans une liste séparée par des virgules. Associer before-hook-creation à hook-succeeded supprime les exécutions obsolètes et nettoie après chaque réussite.

La spécification d’un Job ne peut plus être modifiée une fois celui-ci créé. before-hook-creation évite ce problème en supprimant d’abord l’ancien Job, afin que chaque mise à niveau en crée un nouveau.

Choisissez la stratégie qui correspond à votre objectif : nettoyer en cas de réussite, conserver les éléments utiles au diagnostic des échecs ou toujours repartir de zéro. Chaque annotation indique simplement quand supprimer.

Ces stratégies s’appliquent uniquement aux ressources créées par Helm en tant que crochets. Helm les suit et les supprime pour vous, ce qui vous évite d’exécuter manuellement kubectl delete après chaque version.

L’annotation hook-delete-policy détermine quand Helm supprime un crochet : en cas de réussite, en cas d’échec ou avant la création suivante. La valeur par défaut est before-hook-creation. 🧹