Renderizado de charts de Helm con Kapitan
Kapitan renderiza charts de Helm de forma nativa con input_type: helm. Declaras el chart como una
dependencia (Kapitan lo obtiene) y una entrada de compilación (Kapitan lo plantilla con tus valores).
Los manifiestos renderizados terminan en compiled/; nunca añades el chart manualmente ni ejecutas helm tú mismo.
Dos mitades viven bajo un mismo bloque parameters.<app>, referenciadas mediante autoenlaces ${<app>:key}
para que un valor se escriba una sola vez.
Forma
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}
Las dos mitades
- Dependencia (
type: helm) obtiene el chart desdesourceen laversionhaciaoutput_path. Solo se ejecuta cuando la obtención está habilitada, por lo que la primera compilación de un objetivo necesita una obtención; las compilaciones posteriores reutilizan el chart obtenido. - Compilación (
input_type: helm) plantilla el chart obtenido.helm_params.release_nameyhelm_params.namespaceson las banderas dehelm template;helm_valueses el documento de valores pasado al chart.
Contrato clave
chart_name, chart_version, namespace y helm_values son los valores que tú estableces;
todo lo demás los referencia con ${<app>:...}. Mantén chart_dir apuntando a donde la
dependencia obtiene los archivos, o la entrada de compilación plantillará un directorio vacío y no emitirá nada.
Algunos inventarios (especialmente los de omegaconf) envuelven todo este bloque en un resolvedor personalizado para que una
sola línea se expanda a las entradas de dependencia y compilación, lo que hace que los charts sean duplicables.
El contrato subyacente sigue siendo las dos mitades anteriores; consulta kapitan-omegaconf-resolvers para
ese mecanismo de reutilización.
Después de editar
Compila y haz diff (kapitan_compile_diff) para revisar los manifiestos renderizados. Un cambio de versión de chart es una
modificación de chart_version más una reobtención, nunca una edición manual de compiled/.
Validado con
Kapitan 0.34 a 0.36 con Helm 3.