Passando escopo para um modelo nomeado

Um modelo nomeado só pode ler o que você passar a ele. O segundo argumento de include é o escopo, o ponto que o fragmento verá internamente.

Esse ponto final é o contexto atual. Passar o ponto raiz dá ao fragmento acesso a .Values, .Release e .Chart.

Se você chamar um fragmento sem um escopo, o ponto dele se tornará nil. Qualquer referência a .Values dentro dele será renderizada vazia ou gerará erros.

A maioria dos auxiliares espera o contexto completo do gráfico, então você passa o ponto simples. Esse é o padrão seguro que faz os auxiliares padrão funcionarem.

Às vezes, um fragmento precisa apenas de uma parte dos valores. Você pode passar uma subárvore para que o ponto dela aponte exatamente para essa parte.

Quando você passa .Values.service, o ponto do fragmento passa a ser esse objeto. Ele lê .port diretamente, em vez de .Values.service.port.

Restringir o escopo é útil, mas impede o acesso a .Release e aos valores globais. O fragmento só vê o objeto que você passou.

Precisa de uma subárvore e da raiz? Crie um pequeno dict e passe-o; depois, acesse cada parte pela respectiva chave dentro do fragmento.

Dentro do fragmento, desempacote o dict pela chave. Agora você tem a raiz por meio de .top e a subárvore por meio de .svc, ambas disponíveis ao mesmo tempo.

O erro clássico é um fragmento que lê .Release.Name, mas foi chamado com um escopo restrito. Sempre verifique qual contexto você realmente passou.

Execute helm template . e confirme se a saída do fragmento está preenchida. Campos vazios geralmente significam que o escopo errado chegou ao fragmento.

O argumento após o nome de um fragmento define seu ponto. Passe o ponto raiz, uma subárvore ou um dict para combinar ambos. Escopo errado significa saída vazia. 🎯