Renderizando Helm charts com Kapitan
Kapitan renderiza Helm charts nativamente com input_type: helm. Você declara o chart como uma
dependência (Kapitan o busca) e uma entrada de compilação (Kapitan o templateia com seus valores).
Os manifestos renderizados vão para compiled/; você nunca faz vendor do chart nem executa helm manualmente.
Duas metades vivem sob um único bloco parameters.<app>, referenciadas por auto-links ${<app>:key}
para que um valor seja escrito uma única vez.
Estrutura
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}
As duas metades
- Dependência (
type: helm) baixa o chart desourcenaversionparaoutput_path. Só é executada quando a busca está habilitada, portanto a primeira compilação de um target precisa de uma busca; compilações posteriores reutilizam o chart baixado. - Compilação (
input_type: helm) templateia o chart baixado.helm_params.release_nameehelm_params.namespacesão as flags dohelm template;helm_valuesé o documento de valores passado para o chart.
Contrato principal
chart_name, chart_version, namespace e helm_values são os valores que você define;
todo o resto os referencia com ${<app>:...}. Mantenha chart_dir apontando para onde a
dependência baixa o chart, ou a entrada de compilação templateia um diretório vazio e não emite nada.
Alguns inventários (especialmente os baseados em omegaconf) envolvem todo esse bloco em um resolver
personalizado, de modo que uma única linha expande para as entradas de dependência e compilação,
tornando os charts duplicáveis. O contrato subjacente ainda são as duas metades acima; consulte
kapitan-omegaconf-resolvers para esse mecanismo de reutilização.
Após editar
Compile e faça diff (kapitan_compile_diff) para revisar os manifestos renderizados. Um bump de
chart é uma alteração em chart_version seguida de uma nova busca, nunca uma edição manual de
compiled/.
Validado contra
Kapitan 0.34 até 0.36 com Helm 3.