Fonctions Helm

Les fonctions s’utilisent avec le pipe | pour enchaîner les transformations : {{ .Values.clé | fonction1 | fonction2 }}

---

Fonctions de texte

Fonction	Rôle	Exemple	Résultat
quote	Guillemets doubles	{{ .Values.version | quote }}	"1.2.3"
squote	Guillemets simples	{{ .Values.env | squote }}	'prod'
upper	Majuscules	{{ .Values.env | upper }}	PRODUCTION
lower	Minuscules	{{ .Values.name | lower }}	mon-app
title	Première lettre majuscule	{{ .Values.name | title }}	Mon-App
replace	Remplacement	{{ .Values.url | replace "." "-" }}	mon-site-com
trunc	Tronquer	{{ .Values.name | trunc 63 }}	max 63 chars
trimSuffix	Supprimer un suffixe	{{ "nom-" | trimSuffix "-" }}	nom

---

Fonctions de sécurité et logique

Fonction	Rôle	Exemple
default	Valeur de repli si absent/vide	{{ .Values.count | default 1 }}
required	Stoppe le déploiement si manquant	{{ .Values.token | required "Token requis !" }}

# default : évite le crash si la variable n'est pas définie
replicas: {{ .Values.replicaCount | default 1 }}
 
# required : force l'utilisateur à fournir la valeur
token: {{ .Values.apiToken | required "Le token API est obligatoire !" }}

---

Fonctions de structure YAML

Fonction	Rôle
toYaml	Sérialise un objet complexe en YAML
nindent N	Nouvelle ligne + N espaces d’indentation
indent N	N espaces d’indentation (sans nouvelle ligne)

# values.yaml
labels:
  team: data
  project: analysis
 
# template.yaml
metadata:
  labels:
    {{- toYaml .Values.labels | nindent 4 }}
 
# Résultat :
metadata:
  labels:
    team: data
    project: analysis

---

Fonctions d’encodage

Fonction	Rôle	Exemple
b64enc	Encodage Base64 (obligatoire pour les Secrets K8s)	{{ .Values.password | b64enc | quote }}
b64dec	Décodage Base64	{{ .Values.encoded | b64dec }}
sha256sum	Hash SHA-256	{{ .Values.config | sha256sum }}

---

Fonctions de calcul et listes

Fonction	Rôle	Exemple	Résultat
printf	Chaîne formatée (style C/Go)	{{ printf "%s/%s:%s" .Values.reg .Values.repo .Values.tag }}	docker.io/my-app:v1.0
join	Fusionne une liste avec un séparateur	{{ join "," .Values.hosts }}	a.com,b.com
dict	Crée un dictionnaire inline	(dict "key1" .Val1 "key2" $)	map[key1:… key2:…]

---

Flux de données — exemple complet

# Vérifier → encoder → formater
password: {{ .Values.db.password | required "MDP requis" | b64enc | quote }}
# 1. required  : stoppe si absent
# 2. b64enc    : encode pour Kubernetes Secret
# 3. quote     : ajoute les guillemets YAML
 
# Nom standardisé K8s (max 63 chars)
name: {{ printf "%s-%s" .Release.Name .Chart.Name | trunc 63 | trimSuffix "-" }}
 
# Injecter un bloc YAML complet
{{- toYaml .Values.config | nindent 2 }}

---

Cheat sheet

Catégorie	Fonction	Usage
Sécurité	required	{{ .V.cle | required "Err" }}
Sécurité	default	{{ .V.cle | default 1 }}
Format	quote	{{ .V.cle | quote }}
Format	nindent	{{ include "x" . | nindent 4 }}
Texte	upper	{{ .V.cle | upper }}
Texte	printf	{{ printf "%s-%s" .V.a .V.b }}
Secret	b64enc	{{ .V.cle | b64enc }}
Objet	toYaml	{{ toYaml .V.objet }}
Liste	join	{{ join "," .V.liste }}

---

En relation avec

• Templating — Vue d’ensemble — hub templating
• Conditions et boucles — fonctions utilisées dans les conditions
• _helpers.tpl — fonctions réutilisées dans les helpers