Rendu des charts Helm avec Kapitan
Kapitan effectue le rendu des charts Helm nativement avec input_type: helm. Vous déclarez le chart comme une dépendance (Kapitan le récupère) et une entrée de compilation (Kapitan le template avec vos valeurs). Les manifestes rendus atterrissent dans compiled/ ; vous ne vendez jamais le chart ni n'exécutez helm vous-même.
Deux moitiés vivent sous un seul bloc parameters.<app>, référencées par des auto-liens ${<app>:key} afin qu'une valeur ne soit écrite qu'une seule fois.
Structure
parameters:
cert-manager:
chart_name: cert-manager
chart_version: "v1.4.0"
chart_dir: system/sources/charts/${cert-manager:chart_name}
application_version: "v1.4.0"
namespace: ${namespace}
helm_values:
installCRDs: true
prometheus:
enabled: true
kapitan:
dependencies:
- type: helm
output_path: ${cert-manager:chart_dir}
source: https://charts.jetstack.io/
version: ${cert-manager:chart_version}
chart_name: ${cert-manager:chart_name}
compile:
- input_type: helm
input_paths:
- ${cert-manager:chart_dir}
output_path: .
helm_params:
namespace: ${cert-manager:namespace}
release_name: ${cert-manager:chart_name}
helm_values: ${cert-manager:helm_values}
Les deux moitiés
- Dépendance (
type: helm) récupère le chart depuissourceà laversionspécifiée dansoutput_path. Elle ne s'exécute que lorsque la récupération est activée, donc la première compilation d'une cible nécessite une récupération ; les compilations suivantes réutilisent le chart déjà récupéré. - Compilation (
input_type: helm) template le chart récupéré.helm_params.release_nameethelm_params.namespacesont les indicateurs dehelm template;helm_valuesest le document de valeurs passé au chart.
Contrat clé
chart_name, chart_version, namespace et helm_values sont les valeurs que vous définissez ; tout le reste les référence avec ${<app>:...}. Assurez-vous que chart_dir pointe vers l'endroit où la dépendance récupère le chart, sinon l'entrée de compilation templatera un répertoire vide et n'émettra rien.
Certains inventaires (notamment ceux utilisant omegaconf) encapsulent tout ce bloc dans un résolveur personnalisé afin qu'une seule ligne se développe en entrées de dépendance et de compilation, ce qui rend les charts duplicables. Le contrat sous-jacent reste les deux moitiés ci-dessus ; voir kapitan-omegaconf-resolvers pour ce mécanisme de réutilisation.
Après modification
Compilez et différenciez (kapitan_compile_diff) pour examiner les manifestes rendus. Un changement de chart est une modification de chart_version accompagnée d'une nouvelle récupération, jamais une édition manuelle de compiled/.
Validé avec
Kapitan 0.34 à 0.36 avec Helm 3.