Конвертер JSON в YAML

Что такое YAML и зачем конвертировать из JSON?

// Convert JSON to YAML in Node.js using the eemeli/yaml library
import { Document } from 'yaml';

const data = JSON.parse('{"apiVersion":"apps/v1","kind":"Deployment"}');

// version: '1.1' ensures Norway-problem strings (yes/no/on/off/y/n)
// are automatically quoted in the output for YAML 1.1 parser safety
const doc = new Document(data, { version: '1.1' });

const yamlString = doc.toString({
  indent: 2,
  lineWidth: 0,         // disable line wrapping
  defaultStringType: 'PLAIN',   // Auto mode: only quote when needed
});

console.log(yamlString);
// apiVersion: apps/v1
// kind: Deployment

Ключевые возможности

Примеры

{"apiVersion":"apps/v1","kind":"Deployment","metadata":{"name":"my-app","namespace":"production","labels":{"app":"my-app","version":"1.0.0"}},"spec":{"replicas":3,"selector":{"matchLabels":{"app":"my-app"}},"template":{"metadata":{"labels":{"app":"my-app"}},"spec":{"containers":[{"name":"my-app","image":"my-app:1.0.0","ports":[{"containerPort":8080}],"resources":{"requests":{"memory":"64Mi","cpu":"250m"},"limits":{"memory":"128Mi","cpu":"500m"}}}]}}}}

{"version":"3.9","services":{"web":{"image":"nginx:1.25-alpine","ports":["80:80","443:443"],"environment":{"NGINX_HOST":"example.com","NGINX_PORT":"80"},"depends_on":["db"],"restart":"unless-stopped"},"db":{"image":"postgres:16-alpine","environment":{"POSTGRES_DB":"mydb","POSTGRES_USER":"admin","POSTGRES_PASSWORD":"secret"},"volumes":["pgdata:/var/lib/postgresql/data"]}},"volumes":{"pgdata":{}}}

{"name":"CI","on":{"push":{"branches":["main"]},"pull_request":{"branches":["main"]}},"jobs":{"build":{"runs-on":"ubuntu-latest","steps":[{"uses":"actions/checkout@v4"},{"name":"Set up Node.js","uses":"actions/setup-node@v4","with":{"node-version":"20","cache":"pnpm"}},{"name":"Install dependencies","run":"pnpm install --frozen-lockfile"},{"name":"Run tests","run":"pnpm test"}]}}}

{"openapi":"3.0.3","info":{"title":"User API","version":"1.0.0","description":"Manage application users"},"paths":{"/users":{"get":{"summary":"List users","operationId":"listUsers","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/User"}}}}}}}},"/users/{id}":{"get":{"summary":"Get user","operationId":"getUser","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"}}}}},"components":{"schemas":{"User":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"}}}}}}

{"name":"my-app","version":"1.0.0","description":"A sample Node.js application","private":true,"scripts":{"dev":"vite","build":"tsc && vite build","preview":"vite preview","test":"vitest","lint":"eslint . --ext .ts,.tsx"},"dependencies":{"react":"^18.3.0","react-dom":"^18.3.0"},"devDependencies":{"typescript":"^5.4.0","vite":"^5.2.0","vitest":"^1.5.0","eslint":"^8.57.0","@types/react":"^18.3.0"},"engines":{"node":">=20.0.0","pnpm":">=9.0.0"}}

{"format_version":"1.0","terraform_version":"1.7.4","variables":{"region":{"value":"us-east-1"}},"planned_values":{"root_module":{"resources":[{"address":"aws_s3_bucket.main","mode":"managed","type":"aws_s3_bucket","name":"main","values":{"bucket":"my-app-assets","force_destroy":false,"tags":{"Environment":"production","ManagedBy":"terraform"}}}]}},"resource_changes":[{"address":"aws_s3_bucket.main","mode":"managed","type":"aws_s3_bucket","name":"main","change":{"actions":["create"],"before":null,"after":{"bucket":"my-app-assets","force_destroy":false}}}]}

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

1. 1

   Вставьте JSON

   Введите или вставьте JSON в поле ввода. Можно нажать «Загрузить пример», чтобы попробовать на готовом — например, K8s Deployment, Docker Compose или Terraform plan.

2. 2

   Смотрите live YAML

   YAML появляется в панели вывода мгновенно. Настройте параметры (отступ 2/4, кавычки Auto/Double/Single, стиль Block/Flow) под требования целевого инструмента.

3. 3

   Скопируйте или скачайте

   Нажмите «Скопировать», чтобы поместить YAML в буфер обмена, или «Скачать», чтобы сохранить как .yaml для kubectl apply, docker compose up или другого инструмента.

Типичные ловушки конвертации

{"name": "Alice", "role": "admin",}

{"name": "Alice", "role": "admin"}

{'name': 'Alice', 'active': true}

{"name": "Alice", "active": true}

{name: "Alice", role: "admin"}

{"name": "Alice", "role": "admin"}

{"port": 8080 // HTTP port}

{"port": 8080}

# JSON input: {"country": "no", "enabled": "yes"}
# YAML without quoting (dangerous):
country: no
enabled: yes
# YAML 1.1 parser reads: country=false, enabled=true

# YAML with Auto quoting (safe):
country: 'no'
enabled: 'yes'
# YAML 1.1 parser reads: country="no", enabled="yes"

// JSON input (resourceVersion is int64 on K8s server)
{"resourceVersion": 9007199254740993}
// JavaScript reads it as: 9007199254740992 (precision lost)
// YAML output will contain the wrong number

// Store large integers as strings to preserve precision
{"resourceVersion": "9007199254740993"}
// YAML output: resourceVersion: '9007199254740993' (exact)

Типичные сценарии

Манифесты Kubernetes

Конвертация JSON-ответов API из kubectl get -o json или Kubernetes API в YAML-манифесты для GitOps, Kustomize-overlay и kubectl apply -f.

Файлы Docker Compose

Преобразование JSON-вывода docker inspect или программно сгенерированных конфигураций в файлы docker-compose.yaml для docker compose up и Docker Stack.

Helm chart values

Конвертация JSON-экспорта в YAML values для Helm-деплоев, обеспечивая version-controlled инфраструктурную конфигурацию с чистым синтаксисом.

Workflow GitHub Actions

Программное построение определений GitHub Actions в JSON и конвертация в формат .github/workflows/*.yaml, нужный runner.

OpenAPI-спецификации

Конвертация OpenAPI/Swagger из JSON, который возвращают многие фреймворки (FastAPI, SpringDoc), в YAML, предпочитаемый Swagger UI, Redoc и API-gateway инструментами.

Миграция конфигурации

Миграция конфигов в JSON (appsettings.json, config.json) в YAML для инструментов, требующих или предпочитающих YAML, с возможностью комментариев.

Технические детали

Разбор JSON по RFC 8259

Вход разбирается через нативный JSON.parse(), полностью соответствующий RFC 8259. Это даёт точные сообщения об ошибках синтаксиса (включая позицию) и обрабатывает все типы JSON: строки, числа, булевы, null, массивы и объекты.

Вывод YAML 1.2 через eemeli/yaml Document API со схемой YAML 1.1

YAML генерируется библиотекой eemeli/yaml (v2.8+, CVE-safe) через Document API с version: '1.1'. Это даёт вывод, совместимый с YAML 1.2, применяя при этом правила закавычивания YAML 1.1 — Norway-строки автоматически закавычиваются. Перенос строк отключён (lineWidth: 0).

100% в браузере — без загрузок и сервера

Вся обработка идёт в JavaScript-движке браузера. Никакие данные не передаются по сети. Входы больше 200 КБ автоматически переключаются из live в ручной режим (требуется явный клик «Конвертировать»), чтобы браузер оставался отзывчивым.

Лучшие практики

Всегда используйте Auto для DevOps-конфигов

При конвертации JSON для Kubernetes, Helm, Ansible, Docker Compose или GitHub Actions всегда используйте режим Auto (Norway-safe). YAML 1.1 парсеры в этих инструментах молча принимают yes, no, on, off, y, n за булевы — Auto предотвращает это прозрачно.

2 пробела для cloud-native инструментов

Kubernetes, Docker Compose, GitHub Actions и Helm используют отступ 2 пробела по конвенции. 4 пробела в этих файлах валидны, но создают несогласованность с примерами сообщества и существующими манифестами команды.

Большие целые — как строки перед конвертацией

resourceVersion, uid Kubernetes и другие int64 поля API-сервера могут превышать безопасный диапазон JavaScript (2^53 - 1). Если нужна точная числовая точность, храните их как JSON-строки. Особенно важно для kubectl get -o json вывода с серверными полями.

Сначала проверьте JSON

Если JSON-источник — рукописный или из системы, иногда дающей невалидный вывод (конечные запятые, ключи без кавычек, комментарии), проверьте его форматировщиком JSON перед конвертацией. Используйте наш форматировщик JSON, чтобы поймать и исправить ошибки.

Block-стиль для файлов в Git

Block-стиль YAML даёт чистые читаемые diff в Git: каждое поле на своей строке. Flow (компактный inline) усложняет diff и review. Оставьте Flow для коротких YAML-фрагментов в документации или инструментов с компактным выводом.

Часто задаваемые вопросы