Kapitan으로 Helm 차트 렌더링하기
Kapitan은 input_type: helm을 사용하여 Helm 차트를 네이티브로 렌더링합니다. 차트를 종속성(Kapitan이 가져옴)과 컴파일 항목(Kapitan이 사용자 값으로 템플릿화)으로 선언합니다.
렌더링된 매니페스트는 compiled/에 저장됩니다. 차트를 직접 관리하거나 helm을 직접 실행할 필요가 없습니다.
두 부분이 하나의 parameters.<app> 블록 아래에 있으며, ${<app>:key} 셀프 링크로 참조되므로 값은 한 번만 작성됩니다.
구조
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}
두 부분
- 종속성 (
type: helm) :source에서version의 차트를 가져와output_path에 저장합니다. 페치가 활성화된 경우에만 실행되므로, 타겟의 첫 번째 컴파일에는 페치가 필요합니다. 이후 컴파일은 가져온 차트를 재사용합니다. - 컴파일 (
input_type: helm) : 가져온 차트를 템플릿화합니다.helm_params.release_name과helm_params.namespace는helm template플래그이며,helm_values는 차트에 전달되는 값 문서입니다.
핵심 규약
chart_name, chart_version, namespace, helm_values는 사용자가 설정하는 값입니다. 나머지는 모두 ${<app>:...}로 이를 참조합니다. chart_dir이 종속성이 가져오는 위치를 가리키도록 유지해야 합니다. 그렇지 않으면 컴파일 항목이 빈 디렉토리를 템플릿화하여 아무것도 출력하지 않습니다.
일부 인벤토리(특히 omegaconf 기반)는 이 전체 블록을 사용자 정의 리졸버로 감싸서 한 줄로 종속성 및 컴파일 항목을 확장하므로 차트를 복제할 수 있습니다. 기본 규약은 여전히 위의 두 부분이며, 해당 재사용 메커니즘에 대해서는 kapitan-omegaconf-resolvers를 참조하십시오.
편집 후
렌더링된 매니페스트를 검토하려면 컴파일 및 diff(kapitan_compile_diff)를 수행하십시오. 차트 업데이트는 chart_version 변경 후 재페치를 통해 이루어지며, compiled/를 직접 편집하지 않아야 합니다.
검증 환경
Kapitan 0.34~0.36, Helm 3.