Validação de esquema com values.schema.json
Rejeite valores inválidos antes da renderização.
Validação de esquema com values.schema.json é uma aula grátis de Helm Academy no CoddyKit. Esta é a aula 4 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.
Proteja seus valores
Os usuários podem passar quaisquer valores para o seu chart. Um arquivo values.schema.json permite rejeitar entradas inválidas antes que um único modelo seja renderizado. 🚧
É JSON Schema
O arquivo segue o formato padrão JSON Schema. Você descreve a estrutura, os tipos e os campos obrigatórios que seus valores devem ter.
Onde ele fica
Coloque values.schema.json na raiz do chart, bem ao lado de values.yaml. O Helm o identifica automaticamente, sem sinalizadores adicionais.
Um esquema mínimo
Todo esquema começa com um tipo object e um bloco properties que descreve cada valor aceito pelo seu chart.
{
"type": "object",
"properties": {}
}Definindo o tipo de um campo
Dentro de properties, você declara o tipo de cada campo, como integer para uma contagem de réplicas, fazendo com que uma cadeia de caracteres seja rejeitada.
"replicaCount": { "type": "integer" }Marcando campos como obrigatórios
A matriz required lista os campos que devem estar presentes. Omita um deles e o Helm se recusará a renderizar o chart.
"required": ["image"]Restringindo valores
Você pode adicionar limites, como minimum, para que um replicaCount menor que um seja identificado imediatamente como inválido.
"replicaCount": { "type": "integer", "minimum": 1 }Limitando a um conjunto
Use enum para permitir apenas determinadas cadeias de caracteres, como um tipo de serviço ClusterIP, NodePort ou LoadBalancer.
"type": { "enum": ["ClusterIP", "NodePort"] }Quando ocorre a validação
O Helm valida de acordo com o esquema durante install, upgrade, template e lint, portanto os valores inválidos são bloqueados em todos esses casos.
Mensagens de falha claras
Quando os valores violam o esquema, o Helm para e informa exatamente qual campo é inválido, tornando as correções rápidas e evidentes.
Error: values don't meet the specifications of the schema(s)Por que isso importa
Um esquema transforma configurações incorretas silenciosas em erros claros e antecipados, protegendo os usuários do seu chart contra surpresas em produção.
Verificação rápida
Você quer que um pacote rejeite uma instalação quando o valor da imagem estiver ausente. O que deve usar?
Recapitulação
Você aprendeu que values.schema.json valida a entrada do usuário com JSON Schema, usando type, required, minimum e enum para bloquear valores inválidos logo no início. 🎉
Perguntas Frequentes
A aula “Validação de esquema com values.schema.json” é grátis?
Sim — o texto completo de “Validação de esquema com values.schema.json” é 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 “Validação de esquema com values.schema.json”?
Rejeite valores inválidos antes da renderização. 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 4 de 4.
Quanto tempo leva a aula “Validação de esquema com values.schema.json”?
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
- Verificações estáticas com helm lint
- Verificando a saída com helm template
- Escrevendo casos de teste de helm
- Validação de esquema com values.schema.json