Déboguer les espaces du rendu

La logique du modèle peut laisser des lignes vides et des espaces superflus. Cet espacement invisible est une cause fréquente du refus d’analyse du YAML généré.

Ne devinez plus : regardez. La commande helm template transforme votre paquet en manifestes simples afin que vous puissiez lire la sortie exacte.

En l’associant à --debug, vous affichez la sortie générée même lorsque le rendu échoue, c’est-à-dire précisément au moment où vous avez le plus besoin de la voir.

Une action if ou range qui est supprimée laisse souvent une ligne vide à l’endroit où elle se trouvait. Ces lignes vides peuvent discrètement rendre une liste ou un dictionnaire invalide.

Ajoutez un tiret dans les accolades pour supprimer les espaces environnants. {{- ... }} supprime les espaces à gauche et ... -}} ceux à droite.

Faites passer la sortie dans un outil qui révèle les espaces et les tabulations. L’affichage des octets bruts rend immédiatement évidente la présence d’un espace final ou d’une tabulation superflue.

YAML interdit les tabulations pour l’indentation. Une seule tabulation qui se glisse dans votre modèle produit une sortie que l’analyseur rejette catégoriquement.

Lorsqu’une erreur indique une ligne, générez la sortie dans un fichier et allez directement à cette ligne. Lire la ligne concernée dans son contexte révèle généralement le mauvais espacement.

Exécutez helm lint en parallèle du rendu du modèle. Cette commande signale de nombreuses erreurs de structure, notamment certains problèmes d’espacement, avant même le déploiement.

Procédez par cycles : ajustez un tiret, effectuez à nouveau le rendu, puis relisez la sortie. Cette courte boucle de rétroaction est le chemin le plus rapide vers un YAML propre.

Un espace placé après une valeur est invisible dans la plupart des éditeurs, mais peut tout de même perturber l’analyseur. Révéler les caractères permet de détecter définitivement ces problèmes.

helm template échoue et vous voulez tout de même voir la sortie partiellement générée afin de trouver une ligne vide superflue.

Vous savez maintenant effectuer un rendu avec helm template --debug, révéler les caractères masqués, supprimer les espaces avec le tiret et recommencer jusqu’à obtenir un YAML propre. ✨