JSON в Docker Compose YAML

Создайте корректный compose.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 Выйти из полноэкранного режима
Размер текста в редакторе

Порты и значения окружения надёжно в кавычках

Файлы Compose читаются парсерами YAML 1.1, где 22:22 является шестидесятеричным числом, а NO означает false. Каждая неоднозначная строка заключается в кавычки, чтобы сервисы запускались с теми значениями, которые вы написали.

JSON
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": [
        "80:80",
        "22:22"
      ],
      "environment": {
        "DEBUG": "false",
        "WORKERS": "4",
        "COUNTRY": "NO"
      }
    }
  }
}
compose.yaml
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
      - '22:22'
    environment:
      DEBUG: 'false'
      WORKERS: '4'
      COUNTRY: 'NO'

Для файлов Compose держите Совместимость с YAML 1.1 включённой. Выключите её выше, чтобы увидеть 22:22 без кавычек и то, во что его превращает парсер YAML 1.1.

Проверьте результат с помощью Docker

docker compose config проверяет файл и выводит итоговую модель, причём может вывести её и в JSON.

bash
# Validate a compose file and print the fully resolved model
docker compose config

# The same model as JSON, e.g. to inspect it with jq
docker compose config --format json | jq '.services | keys'

Советы по Compose

Используйте compose.yaml

Это предпочтительное имя файла. docker-compose.yml по-прежнему работает для старых проектов.

Уберите ключ version

Поле version верхнего уровня устарело; текущий Docker Compose игнорирует его и выводит предупреждение.

Список или словарь для env

environment принимает словарь (KEY: value) или список (- KEY=value). Словари из объектов JSON читать проще.

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

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

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

Как конвертировать JSON в файл Docker Compose?

Вставьте JSON в редактор и скопируйте YAML справа в compose.yaml. Сохраните ключи верхнего уровня services, volumes и networks, затем выполните docker compose config, чтобы проверить результат.

Почему сопоставления портов вроде "80:80" в кавычках?

Парсеры YAML 1.1 читают числа без кавычек, разделённые двоеточиями, такие как 22:22, как шестидесятеричные целые. Docker рекомендует всегда заключать сопоставления портов в кавычки, и конвертер делает это за вас, пока включена «Совместимость с YAML 1.1».

Как называть файл: compose.yaml или docker-compose.yml?

compose.yaml является предпочтительным именем в текущей спецификации Compose; docker-compose.yml и docker-compose.yaml по-прежнему читаются для обратной совместимости.

Нужен ли ещё ключ version?

Нет. Ключ version верхнего уровня в спецификации Compose устарел, и Docker Compose игнорирует его, выводя предупреждение. Его можно не указывать.

Можно ли конвертировать файл compose обратно в JSON?

Да. Переключите направление на YAML → JSON или выполните docker compose config --format json, который также разрешает переменные, extends и профили.