Rendern von Helm-Charts mit Kapitan
Kapitan rendert Helm-Charts nativ mit input_type: helm. Sie deklarieren das Chart als
Abhängigkeit (Kapitan lädt es herunter) und einen Kompilierungseintrag (Kapitan erstellt das Template mit Ihren Werten).
Die gerenderten Manifeste landen in compiled/; Sie binden das Chart weder ein noch führen Sie helm selbst aus.
Zwei Hälften leben unter einem parameters.<app>-Block, die durch ${<app>:key}-Selbstverweise referenziert werden,
sodass ein Wert nur einmal geschrieben wird.
Struktur
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}
Die zwei Hälften
- Abhängigkeit (
type: helm) lädt das Chart vonsourcemit derversionin denoutput_path. Sie wird nur ausgeführt, wenn das Abrufen aktiviert ist. Der erste Kompilierungsdurchlauf eines Ziels benötigt daher einen Abruf; spätere Kompilierungen verwenden das bereits abgerufene Chart erneut. - Kompilierung (
input_type: helm) erstellt das Template mit dem abgerufenen Chart.helm_params.release_nameundhelm_params.namespacesind die Flags vonhelm template;helm_valuesist das Werte-Dokument, das an das Chart übergeben wird.
Schlüsselvertrag
chart_name, chart_version, namespace und helm_values sind die von Ihnen gesetzten Werte;
alles andere referenziert sie mit ${<app>:...}. Achten Sie darauf, dass chart_dir auf den Ort zeigt,
wo die Abhängigkeit abgelegt wird, sonst erstellt der Kompilierungseintrag ein leeres Verzeichnis und gibt nichts aus.
Manche Inventare (insbesondere omegaconf-basierte) umhüllen diesen gesamten Block in einem benutzerdefinierten Resolver, sodass
eine einzelne Zeile zu den Abhängigkeits- und Kompilierungseinträgen expandiert, was Charts duplizierbar macht.
Der zugrunde liegende Vertrag bleibt dennoch die zwei oben genannten Hälften; siehe kapitan-omegaconf-resolvers für
diesen Wiederverwendungsmechanismus.
Nach dem Bearbeiten
Kompilieren und einen Diff durchführen (kapitan_compile_diff), um die gerenderten Manifeste zu überprüfen. Ein Chart-Bump ist eine
Änderung von chart_version gefolgt von einem erneuten Abruf, niemals eine manuelle Bearbeitung von compiled/.
Getestet mit
Kapitan 0.34 bis 0.36 mit Helm 3.