Consumindo uma biblioteca como dependência

Um pacote de aplicação incorpora uma biblioteca listando-a em dependencies no Chart.yaml, assim como qualquer outro subpacote.

O repository pode ser um caminho de arquivo durante o desenvolvimento ou uma URL HTTP ou OCI em produção. Ambos incorporam os modelos da biblioteca ao seu pacote.

Execute helm dependency update para buscar a biblioteca para o diretório do seu pacote e fixar sua versão em Chart.lock.

Depois de incluídos, os modelos nomeados da biblioteca entram no espaço de nomes de modelos global do seu pacote. Você pode chamá-los como se os tivesse escrito.

Use include para renderizar um modelo de biblioteca no seu próprio manifesto. Ele retorna texto que você pode passar para outras funções.

O ponto depois do nome do modelo é o escopo que você fornece ao fragmento. Passe o contexto raiz para que ele possa ler .Values e .Release.

Ao contrário de template, include retorna uma cadeia de texto, portanto você pode passar o resultado para indent ou nindent e obter o posicionamento correto no YAML.

Adicionar uma dependência de biblioteca não acrescenta zero recursos por si só. Seus próprios modelos determinam o que renderizar ao chamar os fragmentos da biblioteca.

Se a biblioteca definir um objeto completo, o arquivo do seu modelo poderá ser uma única linha de include que emite o Service ou Deployment completo.

Execute helm template no pacote da aplicação para confirmar que os fragmentos da biblioteca foram resolvidos e produziram o YAML esperado.

Fixe a dependência em um intervalo conhecido de version para que uma alteração na biblioteca nunca modifique silenciosamente os manifestos renderizados na CI.

Você chama um fragmento de biblioteca e quer passar o resultado para nindent. Qual diretiva deve usar?

Liste a biblioteca em dependencies, execute helm dependency update e depois chame seus fragmentos com include, passando o contexto. 🔗