Как подружить helm со своим шаблонизатором?

Helm использует go templates для рендеринга манифестов. Есть функции, которые были разработаны специально для helm. Но в большинстве своем используется библиотека Sprig.

Но что, если нам мало функций и мы хотим воспользоваться каким-нибудь своим кастомным шаблонизатором?

В этой статье я покажу пример, как подключить шаблонизатор gomplate. Но это не помешает вам использовать какой-нибудь другой. Принципы одинаковые.

gomplate содержит огромное количество функций по работе со строками, сетью, криптографией и т.д.

Одна из киллер-фичей – получать данные из разных источников: файлы, https, git, ssh, AWS EC2 metadata, AWS Secret Manager, BoltDB, Hashicorp Consul и Hashicorp Vault.

Подготовка

Для начала надо установить helm и gomplate , если они еще не установлены.

$ brew install helm $ brew install gomplate

Первая сложность: gomplate и helm используют одинаковые кавычки-разделители {{ и }} для шаблонов.

Можно было бы начать их экранировать. Но это ни к чему хорошему не приведет. Будет много некрасивого кода и кавычек. Поэтому проще назначить другие кавычки для gomplate.

export GOMPLATE_LEFT_DELIM="[[" export GOMPLATE_RIGHT_DELIM="]]"

Тестируем:

echo 'Hello, [[ .Env.USER ]]' | gomplate Hello, zhilyaev

Создаем helm chart

# [[ defineDatasource "foo" "https://httpbin.org/get" ]]   # [[ if not (datasourceReachable "foo")]] unreachable [[end]] # [[ $d := ds "foo" ]]   apiVersion: v1   kind: ConfigMap   metadata:     name: {{ include "this.fullname" . }}     labels: {{ include "this.labels" . | nindent 4 }}   data:     random: "[[ random.AlphaNum 32 ]]"     host: "[[ $d.headers.Host ]]" 

Переходим к основной части. Helm имеет флажок --post-renderer его мы и будем жадно абузить.

Запускаем:

helm template this chart —post-renderer gomplate

# Source: this/templates/configmap.yaml # #  #  apiVersion: v1 kind: ConfigMap metadata:   name: this   labels:     helm.sh/chart: this-0.1.0     app.kubernetes.io/name: this     app.kubernetes.io/instance: this     app.kubernetes.io/version: "1.16.0"     app.kubernetes.io/managed-by: Helm data:   random: "2tJyK9xSsg1gvEmunEokQf4lyGkvojiQ"   host: "httpbin.org" 

Деплоим:

helm upgrade --install this chart --post-renderer gomplate

Profit

Послесловие

Внедрение --post-renderer вносит дополнительную сложность. Cледуя принципам KISS, попробуйте helmwave. В нем мы решаем повседневные проблемы при работе с helm, не вмешиваясь в функционал чартов.