O objeto Values e o acesso aninhado
Leia a configuração do usuário em profundidade na árvore.
O objeto Values e o acesso aninhado é uma aula grátis de Helm Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Helm Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Helm Academy inclui 4 aulas no total.
Conheça o objeto Values
Dentro de um modelo, .Values contém todas as configurações do values.yaml do seu pacote, além de quaisquer substituições fornecidas. Ele é sua árvore de configuração.
Lendo uma chave de nível superior
Uma chave de nível superior como replicaCount se torna .Values.replicaCount. O caminho pontilhado reflete exatamente a estrutura YAML. 🌳
# values.yaml
replicaCount: 3
# template
replicas: {{ .Values.replicaCount }}Explorando mapas aninhados
Quando os valores estão aninhados, você encadeia pontos. O mapa image com uma chave tag é acessado como .Values.image.tag, um segmento por nível.
# values.yaml
image:
repository: nginx
tag: "1.27"
# template
image: {{ .Values.image.repository }}:{{ .Values.image.tag }}As chaves diferenciam maiúsculas de minúsculas
Os segmentos do caminho precisam corresponder caractere por caractere à chave YAML. .Values.Image não é igual a .Values.image e resulta em uma saída vazia.
Chaves ausentes geram uma saída vazia
Por padrão, pedir um valor que não existe não é um erro. O Helm não gera nada, o que pode produzir YAML inválido silenciosamente.
Chaves com hífens precisam de index
A sintaxe de ponto não funciona com chaves que contêm hífens. Acesse-as com a função index e a chave como uma string entre aspas.
# values.yaml
service-port: 8080
# template
port: {{ index .Values "service-port" }}De onde vêm os valores padrão
O autor do pacote fornece valores padrão adequados em values.yaml. Todas as chaves presentes ali ficam disponíveis em .Values, a menos que um usuário as substitua.
Como as substituições chegam a .Values
O sinalizador --set de um usuário ou o arquivo indicado por -f é mesclado aos valores padrão antes da renderização. No momento de processar o modelo, .Values é a árvore final mesclada.
helm install web ./mychart --set replicaCount=5As listas também ficam em .Values
Uma lista YAML se torna uma sequência em .Values. Você percorre essa sequência com range para gerar itens repetidos, em vez de lê-la com um único caminho pontilhado. 🔁
# values.yaml
ports:
- 80
- 443Colocando valores entre aspas com segurança
Números e valores booleanos são renderizados sem tratamento, o que pode corromper o YAML. Envolva os textos fornecidos pelo usuário na função quote para que continuem sendo texto válido.
tag: {{ .Values.image.tag | quote }}Inspecione a árvore antes de usá-la
Execute helm show values em um pacote para exibir toda a sua árvore de valores. Essa saída tem exatamente o formato que você acessa com .Values.
helm show values ./mychartVerificação rápida
Você precisa de uma chave de valores chamada service-port que contenha um hífen.
Recapitulação: a árvore Values
Você aprendeu que .Values é a árvore de configuração mesclada, acessada com caminhos pontilhados que diferenciam maiúsculas de minúsculas, usando index para chaves difíceis. Inspecione-a com helm show values.
Perguntas Frequentes
A aula “O objeto Values e o acesso aninhado” é grátis?
Sim — o texto completo de “O objeto Values e o acesso aninhado” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Helm Academy, atualize para CoddyKit PRO. O curso de Helm Academy inclui 4 aulas no total.
O que vou aprender em “O objeto Values e o acesso aninhado”?
Leia a configuração do usuário em profundidade na árvore. Você pratica Helm Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Helm Academy?
Nenhuma experiência prévia é necessária. Helm Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “O objeto Values e o acesso aninhado”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Helm Academy?
Sim. Cada aula de Helm Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- O objeto Values e o acesso aninhado
- Metadados da release por meio de .Release
- Objetos Chart e Capabilities
- Files, Template e o contexto raiz