01
Уточните формат
Автоматический режим узнаёт JSON по началу объекта. Если вход неоднозначен, выберите JSON или YAML; ошибка не переключает формат скрытно.
Облачные инструменты
валидация шаблона CloudFormation— найдите локальные ошибки до запуска
Вставьте один шаблон JSON или YAML и изучите диагностику и форматированную копию.
валидация шаблона CloudFormation
Исходный шаблон
Диагностика и просмотр
В охваченных правилах замечаний нет.
Обработка в браузере; запросов к AWS нет.
Введите шаблон или загрузите пример.
Лимит ввода: 300000 символов.
Корректный YAML не гарантирует, что Ref указывает на существующий параметр или что раздел Resources расположен правильно. Валидация шаблона CloudFormation отделяет эти ошибки от синтаксиса.
Для проверки шаблона CloudFormation перед развёртыванием важно видеть границы анализа. Здесь явно перечислены поддерживаемые ресурсы; проверку в AWS всё равно нужно выполнить отдельно. Проверка шаблона CloudFormation здесь показывает найденные локальные ошибки, а проверка синтаксиса YAML CloudFormation не заменяет проверку сервиса AWS.
Зачем нужна валидация шаблона CloudFormation?
Синтаксис отдельно от ссылок
Сбой парсера и неизвестный Ref исправляются по-разному. Валидация шаблона CloudFormation показывает строку, путь и категорию замечания.
Непроверенные ресурсы видны
Проверяются свойства первого уровня для S3 Bucket, SQS Queue и SNS Topic. Остальные типы остаются непокрытыми, а валидация шаблона CloudFormation не выдаёт ложного одобрения.
Как читать формат, версию и охват
02
Сверьте версию и охват
Если версия не указана, используется 2010-09-09. Сравните число проверенных и непокрытых ресурсов перед выводом о результате.
03
Выгружайте свежий отчёт
Изменение текста или отступов делает прежнее копирование и скачивание недоступным. Повторите проверку и сохраните JSON-отчёт либо шаблон в исходном формате.
Статические проверки структуры
Синтаксис JSON и YAML
Разбирается один документ, ошибка получает строку и столбец. Короткие теги YAML !Ref и !Sub сохраняются в форматированном просмотре.
Локальные ссылки
Ref, Fn::GetAtt и простые имена Fn::Sub сверяются с параметрами, ресурсами и псевдопараметрами этого же шаблона.
Ограниченная схема
Имена и базовые типы свойств первого уровня для AWS::S3::Bucket, AWS::SQS::Queue и AWS::SNS::Topic проверяются; вложенные значения не вычисляются.
Границы локального результата
- Только один шаблон
- Вводится один документ JSON или YAML. Отсутствие Resources, неверный логический ID и версия формата выводятся как ошибки; вложенные стеки не раскрываются.
- Схема покрывает не всё
- Неизвестные ресурсы и свойства отмечаются как непроверенные. Валидация шаблона CloudFormation здесь не подтверждает весь каталог AWS.
- Динамические значения не вычисляются
- Имена Ref сверяются локально, но условия, макросы и данные аккаунта не запускаются. Итоговый тип не угадывается.
- Нет действий в AWS
- Учётные данные не запрашиваются, регион не опрашивается, стек не создаётся. Права и квоты проверяйте отдельно в AWS.
Вопросы о валидации шаблона CloudFormation
Как проверить синтаксис шаблона CloudFormation?
Сначала исправьте указанную строку синтаксиса, затем проверьте разделы и ссылки. Локальный отчёт разделяет эти категории.
Когда нужен cfn-lint вместо validate-template?
Проверьте отступы, двоеточия и короткие теги в указанной строке. При ошибке разбора форматированный файл недоступен.
Почему ссылка Ref на параметр не разрешается?
Имя Ref, GetAtt или Sub не найдено среди параметров и ресурсов этого шаблона. Проверьте объявление и написание.
Как отличить синтаксическую проверку от проверки ресурсов?
Сверьте путь в Resources и документацию AWS. Отсутствие свойства в локальной схеме означает пробел покрытия, не окончательный отказ AWS.
Как проверить YAML шаблон до развертывания?
Нет. Здесь выполняются только описанные локальные правила. Условия аккаунта, региона и сервиса проверяются в AWS.
Остался вопрос?
Запустите валидация шаблона CloudFormation
После правки повторите проверку и передайте свежий отчёт на ревью развёртывания.