Проверка схемы с values.schema.json
Отклоняйте недопустимые значения до рендеринга
«Проверка схемы с values.schema.json» — бесплатный урок Helm Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Helm Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Helm Academy содержит 4 уроков всего.
Защитите свои значения
Пользователи могут передать в ваш чарт любые значения. Файл values.schema.json позволяет отклонить некорректные входные данные ещё до рендеринга первого шаблона. 🚧
Это схема JSON
Файл соответствует стандартному формату схемы JSON. Вы описываете структуру, типы и обязательные поля, которые должны присутствовать в ваших значениях.
Где она находится
Поместите values.schema.json в корень чарта, рядом с values.yaml. Helm подхватит её автоматически, без дополнительных параметров.
Минимальная схема
Каждая схема начинается с типа object и блока properties, описывающего каждое значение, которое принимает ваш чарт.
{
"type": "object",
"properties": {}
}Задание типа поля
Внутри properties объявите тип каждого поля, например integer для количества реплик, чтобы строковое значение было отклонено.
"replicaCount": { "type": "integer" }Обязательные поля
Массив required перечисляет поля, которые должны присутствовать. Если пропустить одно из них, Helm откажется рендерить чарт.
"required": ["image"]Ограничение значений
Можно добавить ограничения, например minimum, чтобы значение replicaCount меньше единицы сразу распознавалось как недействительное.
"replicaCount": { "type": "integer", "minimum": 1 }Ограничение набором значений
Используйте enum, чтобы разрешить только определённые строки, например тип сервиса ClusterIP, NodePort или LoadBalancer.
"type": { "enum": ["ClusterIP", "NodePort"] }Когда выполняется проверка
Helm проверяет значения по схеме во время команд install, upgrade, template и lint, поэтому некорректные значения блокируются везде.
Понятные сообщения об ошибках
Если значения нарушают схему, Helm останавливается и точно указывает, какое поле является недействительным, поэтому исправить проблему быстро и просто.
Error: values don't meet the specifications of the schema(s)Почему это важно
Схема превращает незаметные ошибки конфигурации в явные ранние ошибки и защищает пользователей вашего чарта от неожиданностей в рабочей среде.
Быстрая проверка
Вы хотите, чтобы чарт отклонял установку, если значение образа отсутствует. Что следует использовать?
Итоги
Вы узнали, что values.schema.json проверяет пользовательский ввод с помощью схемы JSON, используя type, required, minimum и enum, чтобы заранее блокировать недопустимые значения. 🎉
Часто задаваемые вопросы
Урок «Проверка схемы с values.schema.json» бесплатный?
Да — полный текст урока «Проверка схемы с values.schema.json» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Helm Academy, подпишись на CoddyKit PRO. Курс Helm Academy содержит 4 уроков всего.
Чему я научусь в уроке «Проверка схемы с values.schema.json»?
Отклоняйте недопустимые значения до рендеринга Ты практикуешь Helm Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать Helm Academy?
Предыдущий опыт не требуется. Helm Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.
Сколько времени занимает урок «Проверка схемы с values.schema.json»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке Helm Academy?
Да. Каждый урок Helm Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Статические проверки с helm lint
- Проверка вывода с helm template
- Написание тестов helm test
- Проверка схемы с values.schema.json