CloudFormation: JSON в YAML

Конвертируйте шаблоны AWS CloudFormation в YAML, который развёртывается точно так же, как исходный JSON.

Параметры вывода

JSONввод

Пусто

YAMLвывод

Здесь появится вывод YAML

Работает полностью в вашем браузере: ничего не загружается на сервер. Действуют ограничения добросовестного использования (5 MB на ввод, лимит частоты конвертаций) для защиты от спама и ботов.

Загрузка по URL

Файл запрашивается напрямую вашим браузером, поэтому сервер должен разрешать кросс-доменные запросы.

Сочетания клавиш

Ctrl / ⌘ + Enter Конвертировать сейчас
Ctrl / ⌘ + S Скачать вывод
Alt + Shift + C Копировать вывод
Alt + Shift + F Исправить и отформатировать входной JSON
Alt + Shift + S Поменять направление
Alt + Shift + T Переключение между видами: код, дерево и карта
Ctrl / ⌘ + Z Отменить, в том числе «Формат», «Исправить» и «Очистить»
Esc Выйти из полноэкранного режима
Размер текста в редакторе

Встроенные функции остаются корректными

Ref, Fn::Sub и Fn::GetAtt записываются в полной форме, которую CloudFormation читает в YAML точно так же, как в JSON.

Вывод конвертера (полная форма)
BucketName:
  Fn::Sub: assets-${Environment}
Tags:
  - Key: env
    Value:
      Ref: Environment
Resource:
  Fn::GetAtt:
    - AssetsBucket
    - Arn
Эквивалентная краткая форма
BucketName: !Sub 'assets-${Environment}'
Tags:
  - Key: env
    Value: !Ref Environment
Resource: !GetAtt AssetsBucket.Arn

Обе версии развёртываются одинаково. Теги краткой формы являются расширением CloudFormation, поэтому конвертер сохраняет полную форму, которую читает любой инструмент YAML.

Шаблоны компактнее и проще для ревью

Пример шаблона в YAML на 36% меньше, чем в отформатированном JSON, и на ревью не приходится пробираться через скобки и кавычки.

bash
# Validate the converted template with the AWS CLI
aws cloudformation validate-template --template-body file://template.yaml

Детали CloudFormation, о которых позаботится конвертер

Сравните вывод конвертера с теми же значениями шаблона, записанными вручную без кавычек.

Даты версий

'2010-09-09' и '2012-10-17' остаются строками и не превращаются в даты YAML 1.1.

Строки подстановки

Плейсхолдеры ${AWS::AccountId} внутри Fn::Sub сохраняются символ в символ.

Документы политик

Встроенные политики IAM конвертируются так же, как остальной шаблон, поэтому действия и ресурсы читаются как аккуратные списки.

Другие инструменты

Конвертеры, валидаторы и пошаговые руководства для всех мест, где встречаются JSON и YAML.

Частые вопросы

Как конвертировать шаблон CloudFormation из JSON в YAML?

Вставьте JSON шаблона или загрузите template.json. Скопируйте YAML или скачайте template.yaml и разверните его как любой другой шаблон. Ресурсы, параметры и выводы остаются точно такими же.

Использует ли YAML краткие функции вроде !Ref и !Sub?

Нет. Конвертер пишет полную форму (Ref:, Fn::Sub:, Fn::GetAtt:), которую CloudFormation принимает в шаблонах YAML и которую может прочитать любой парсер YAML. Теги краткой формы являются необязательным сокращением.

Почему AWSTemplateFormatVersion в кавычках?

2010-09-09 без кавычек в YAML 1.1 является датой. CloudFormation ожидает строку, поэтому конвертер пишет '2010-09-09'. Версии политик IAM вроде '2012-10-17' заключаются в кавычки по той же причине.

Можно ли конвертировать шаблон YAML обратно в JSON?

Да, для шаблонов с синтаксисом полной формы: переключите направление на YAML → JSON. Шаблонам с тегами краткой формы, такими как !Ref, нужен инструмент, понимающий CloudFormation, потому что эти теги не являются стандартными типами YAML.

Безопасно ли вставлять шаблоны с данными аккаунта?

Да. Конвертация выполняется в браузере, ничего не загружается и не журналируется, поэтому ID аккаунтов, ARN и значения параметров по умолчанию остаются на вашем компьютере.