Packager son application avec Helm

1. Origine du besoin

Même dans le cas d’une application simple comme MailHog, le déploiement réclame un certain nombre de déclarations :

Malheureusement, dans le cas où l’on ne souhaiterait pas publier l’application sur l’extérieur ou ajouter de volume persistant, il n’y a pas d’autre solution que d’éditer les fichiers à la main avant de les soumettre au cluster ou de n’envoyer qu’une partie des fichiers vers l’API de Kubernetes.

Afin d’éviter ces opérations manuelles, il est possible de faire appel à des préprocesseurs qui prendront ces fichiers en entrée et y appliqueront des modifications avant de les soumettre à l’API de Kubernetes.

Dans le cas de Helm, ce travail de préparation des fichiers se fait à l’aide du moteur de template du langage Go.

2. Création d’un chart

La création d’un package se fait à l’aide de la commande helm suivie des options suivantes :

$ helm create mailhog 

3. Contenu d’un package

1. Principe de fonctionnement

Le mécanisme de template du langage Go part d’une représentation textuelle (un fichier YAML, par exemple) dans laquelle certaines parties sont rendues dynamiques à l’aide des mécanismes suivants :

De ce point de vue, la syntaxe de base est assez proche de moteurs existants comme par exemple Jinja pour Python (utilisé notamment par Ansible) ou du moteur de template de Puppet.

Toutes les opérations réalisées par le moteur utilisent des moustaches avec une partie ouvrante ({{) et une partie fermante (}}).

2. Substitution du contenu d’une variable

Pour afficher le contenu de la variable version déclarée dans le fichier values.yaml, l’appel se fera de la manière suivante :

version contient la valeur suivante : {{ .Values.version }} 

Dans le cas où la variable contient la valeur 1.0, le moteur produira la sortie suivante :

La variable version contient la valeur suivante : 1.0 

3. Blocs conditionnels

Le langage supporte les blocs if/then/else. Il est possible d’afficher le contenu d’un bloc en fonction d’une condition.

Ci-dessous un exemple de bloc de conditions :

{{ if .Values.beauTemps }} 
Je sors sans mon parapluie. 
{{ else }} 
Je prends mon parapluie. 
{{ end }} 

Dans le cas où la condition beauTemps est vraie, le moteur renverra le texte suivant :

Je sors sans mon parapluie. 

Dans le cas où beauTemps est faux, le moteur renverra alors le résultat suivant :

Je prends mon parapluie. 

4. Gestion des conditions