Helm Academy · Aula

Parametrizando a imagem do contêiner

Conecte o repositório e a tag da imagem aos valores.

Parametrizando a imagem do contêiner é uma aula grátis de Helm Academy no CoddyKit. Esta é a aula 2 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.

Por que parametrizar a imagem

Uma imagem definida diretamente prende todos os usuários a uma única versão. Vincular a imagem aos valores permite que as pessoas escolham o repositório e a etiqueta de que precisam.

Separe o repositório e a etiqueta

Por convenção, os pacotes armazenam a imagem em dois campos: um repositório e uma etiqueta. Mantê-los separados facilita as atualizações de versão.

# values.yaml
image:
  repository: nginx
  tag: "1.27"

Leia valores aninhados

Acesse chaves aninhadas encadeando pontos. Aqui, .Values.image.repository percorre o mapa de imagem que você acabou de definir.

image: {{ .Values.image.repository }}

Combine o repositório e a etiqueta

Uma referência de imagem consiste no repositório, seguido de dois-pontos e da etiqueta. Monte-a dentro do modelo para que a linha renderizada seja uma única cadeia válida.

image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"

Sempre coloque a etiqueta entre aspas

Uma etiqueta como 1.27 pode ser interpretada como um número pelo YAML. Coloque as etiquetas entre aspas nos valores para que continuem sendo cadeias e nunca percam um zero à direita.

tag: "1.27.0"

Forneça uma etiqueta padrão adequada

A função valor padrão fornece uma alternativa quando um valor está vazio. Um padrão comum usa o appVersion do pacote como etiqueta padrão.

{{ .Values.image.tag | default .Chart.AppVersion }}

Exponha a política de extração

Permita que os usuários controlem quando o Kubernetes baixa novamente uma imagem, parametrizando também imagePullPolicy. IfNotPresent é um valor padrão seguro.

imagePullPolicy: {{ .Values.image.pullPolicy }}

Defina a política de extração como padrão

Defina o valor padrão da política de extração em values.yaml para que uma instalação funcione sem nenhuma substituição. Os usuários ainda poderão alterá-la quando necessário.

image:
  pullPolicy: IfNotPresent

O bloco completo do contêiner

Agora seu contêiner é totalmente orientado por dados: a imagem e a política de extração vêm de .Values.image, sem literais restantes no modelo.

containers:
  - name: app
    image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
    imagePullPolicy: {{ .Values.image.pullPolicy }}

Substitua durante a instalação

Os usuários ajustam um único valor aninhado com --set. Os pontos na chave correspondem diretamente à sua árvore de valores, sem exigir edições em arquivos.

helm install web . --set image.tag=1.28

Confirme a imagem renderizada

Renderize com uma substituição para comprovar que a configuração funciona de ponta a ponta. A saída deverá mostrar a etiqueta escolhida na linha da imagem.

helm template web . --set image.tag=1.28

Verificação rápida

Você quer instalar uma etiqueta de imagem diferente sem editar arquivos. O que funciona?

Recapitulação: uma imagem configurável

Você separou a imagem em repositório e etiqueta, adicionou uma política de extração e permitiu que os usuários substituíssem cada uma com --set. Coloque as etiquetas entre aspas para mantê-las seguras.

Perguntas Frequentes

A aula “Parametrizando a imagem do contêiner” é grátis?

Sim — o texto completo de “Parametrizando a imagem do contêiner” é 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 “Parametrizando a imagem do contêiner”?

Conecte o repositório e a tag da imagem aos valores. 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 2 de 4.

Quanto tempo leva a aula “Parametrizando a imagem do contêiner”?

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

← Voltar para Helm Academy