Validação de esquema com values.schema.json

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. 🚧

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.

Coloque values.schema.json na raiz do chart, bem ao lado de values.yaml. O Helm o identifica automaticamente, sem sinalizadores adicionais.

Todo esquema começa com um tipo object e um bloco properties que descreve cada valor aceito pelo seu chart.

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.

A matriz required lista os campos que devem estar presentes. Omita um deles e o Helm se recusará a renderizar o chart.

Você pode adicionar limites, como minimum, para que um replicaCount menor que um seja identificado imediatamente como inválido.

Use enum para permitir apenas determinadas cadeias de caracteres, como um tipo de serviço ClusterIP, NodePort ou LoadBalancer.

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.

Quando os valores violam o esquema, o Helm para e informa exatamente qual campo é inválido, tornando as correções rápidas e evidentes.

Um esquema transforma configurações incorretas silenciosas em erros claros e antecipados, protegendo os usuários do seu chart contra surpresas em produção.

Você quer que um pacote rejeite uma instalação quando o valor da imagem estiver ausente. O que deve usar?

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. 🎉