Преобразуйте JSON в YAML!

Введите JSON, чтобы получить читаемый YAML! Поддержка: yml, Kubernetes, docker-compose, Spring application.yml.
JSON
Результат
 

Преобразуйте JSON в YAML!

Превращает JSON в YAML на основе отступов. Фигурные скобки и большая часть кавычек исчезают, так что результат проще поддерживать вручную как конфигурационный файл, а порядок ключей остаётся ровно таким же, как в исходном JSON.

Помогает, когда вы переносите ресурс, полученный через kubectl get -o json, в манифест или вставляете настройки, полученные из API, в docker-compose.yml, application.yml или workflow GitHub Actions.

Как пользоваться

  1. Вставьте JSON в поле JSON. При неверном синтаксисе в результате появится JSON parsing failed; при необходимости сначала прогоните его через валидатор JSON.
  2. Проверьте YAML в Результат. Отступ — два пробела.
  3. Скопируйте его в свой .yml-файл, поправив глубину отступа, если вкладываете его в другой блок.

Пример

Вход (JSON)
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": ["8080:80"],
      "environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
    }
  }
}
Результат (YAML)
services:
  web:
    image: nginx:1.27
    ports:
      - 8080:80
    environment:
      FEATURE_FLAG: "on"
      GREETING: |-
        hello
        world

Строка "on" сохраняет кавычки: без них, как on, парсер YAML 1.1 прочитал бы её как булево true. GREETING содержит перевод строки, поэтому выводится блоком |-, где каждая строка видна как написана.

Возможности

  • Кавычки расставляются по YAML 1.1. Строки вроде yes, no, on, off, y, n, ~, null и похожие на числа и даты, такие как "0777", "1.0" или "2024-01-01", берутся в кавычки, чтобы PyYAML (1.1) и современные парсеры 1.2 читали одно и то же значение.
  • Строки вроде 22:22, которые YAML 1.1 может прочитать как шестидесятеричное число, тоже берутся в кавычки — это избавляет от классического бага с маппингом портов в docker-compose.
  • Многострочные строки становятся литеральными блоками |-.
  • Длинные строки никогда не переносятся (нет ограничения ширины строки).
  • Пустые массивы и объекты остаются как [] и {}.

Сценарии использования

Из JSON-вывода kubectl в манифест

Преобразуйте Deployment или ConfigMap, полученный из кластера в JSON, удалите поля вроде status и metadata.uid — и манифест готов к добавлению в Git.

Написание application.yml для Spring Boot

Блок свойств, полученный в JSON от конфиг-сервера или из документации, превращается в иерархию YAML, так что не нужно вручную расставлять отступы для ключей вроде spring.datasource.url.

Примечания и ограничения

  • Комментарии, якоря (&) и алиасы (*) не генерируются; объект, повторяющийся в JSON, повторяется и в YAML.
  • Целые больше 9007199254740991 теряют точность из-за ограничения чисел в JavaScript; храните длинные ID в JSON строками.
  • Вывод — один документ. Для файла с несколькими ресурсами, разделёнными ---, преобразуйте каждый ресурс и объедините их сами.

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

Почему одни строки в кавычках, а другие нет?

Кавычки добавляются только там, где значение без них было бы прочитано как другой тип. nginx:1.27 — строка в любом случае, а on, 010 и 22:22 в некоторых парсерах превращаются в булевы значения или числа, поэтому получают кавычки.

Можно ли применить вывод к Kubernetes напрямую?

Структура корректна как есть. Однако вывод kubectl get -o json несёт поля, заполняемые сервером, такие как status, resourceVersion и managedFields, и их лучше удалить перед применением.

Можно ли переключиться на отступ в четыре пробела?

Такой опции нет; отступ зафиксирован на двух пробелах — это соглашение, принятое во всей документации Kubernetes, docker-compose и GitHub Actions.