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

Что такое JSON?

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

const yamlString = `apiVersion: apps/v1
kind: Deployment`;

// parseAllDocuments handles multi-document YAML (--- separator)
// version: '1.2' ensures yes/no are strings, not booleans
// merge: true expands anchor/alias merge keys (<<: *anchor)
const docs = parseAllDocuments(yamlString, { version: '1.2', merge: true });

// Take the first document (skip additional --- blocks)
const json = JSON.stringify(docs[0].toJSON(), null, 2);

console.log(json);
// {
//   "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

replicaCount: 3
image:
  repository: my-app
  tag: 1.0.0
  pullPolicy: IfNotPresent
service:
  type: ClusterIP
  port: 80
ingress:
  enabled: true
  className: nginx
  hosts:
    - host: my-app.example.com
      paths:
        - path: /
          pathType: Prefix
resources:
  requests:
    memory: 64Mi
    cpu: 250m
  limits:
    memory: 128Mi
    cpu: 500m
autoscaling:
  enabled: false
  minReplicas: 1
  maxReplicas: 10
  targetCPUUtilizationPercentage: 80

- name: Configure web servers
  hosts: webservers
  become: true
  vars:
    http_port: 80
    max_clients: 200
  tasks:
    - name: Ensure nginx is installed
      ansible.builtin.package:
        name: nginx
        state: present
    - name: Start nginx service
      ansible.builtin.service:
        name: nginx
        state: started
        enabled: true
    - name: Copy nginx config
      ansible.builtin.template:
        src: nginx.conf.j2
        dest: /etc/nginx/nginx.conf
        owner: root
        group: root
        mode: '0644'
      notify:
        - Restart nginx
  handlers:
    - name: Restart nginx
      ansible.builtin.service:
        name: nginx
        state: restarted

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

1. 1

   Вставьте YAML

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

2. 2

   Смотрите live JSON

   JSON появляется в панели вывода мгновенно. Настройте отступ (2 или 4 пробела) под требования целевого инструмента.

3. 3

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

   Нажмите «Скопировать», чтобы поместить JSON в буфер, или «Скачать», чтобы сохранить как .json для jq, API-вызовов или другого downstream-инструмента.

Типичные ловушки YAML

services:
	web:
		image: nginx:1.25-alpine

services:
  web:
    image: nginx:1.25-alpine

metadata:
  name: my-app
   namespace: production

metadata:
  name: my-app
  namespace: production

url: http://example.com:8080/api
tag: #latest

url: 'http://example.com:8080/api'
tag: '#latest'

# Circular anchor (rare but possible)
base: &base
  parent: *base

# Use explicit fields instead of circular references
base:
  parent: null

# Only the first document is converted
apiVersion: v1
kind: ConfigMap
---
apiVersion: v1
kind: Secret

# Convert each document separately
apiVersion: v1
kind: ConfigMap

# This comment will be lost
replicas: 3 # scale this up for production

replicas: 3
_comment: scale this up for production

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

Анализ манифестов Kubernetes

Конвертация YAML-манифестов в JSON для запросов через jq, отправки в Kubernetes REST API, обработки в источниках данных Terraform или передачи в CI/CD-конвейеры, ожидающие JSON.

Docker Compose в JavaScript-инструменты

Разбор YAML Docker Compose в JSON для извлечения определений сервисов, имён образов, маппинга портов и переменных окружения для скриптов автоматизации, графов зависимостей или Node.js-инструментов.

GitHub Actions API integration

Конвертация YAML workflow GitHub Actions в JSON для программной валидации структуры, извлечения определений job и step или интеграции с CI/CD API, принимающими JSON.

OpenAPI в генерацию клиентского кода

Многие генераторы (openapi-generator, swagger-codegen, oazapfts) принимают OpenAPI в любом формате. Конвертируйте YAML-spec в JSON, когда инструмент явно требует JSON или нужна проверка через JSON Schema-валидаторы.

Анализ Helm values

Конвертация Helm values.yaml в JSON для отчётов, сравнения значений между окружениями, передачи в инструменты обеспечения политики или обработки автоматизацией, ожидающей JSON.

Миграция конфигураций в JSON-инструменты

Миграция конфигурации приложения из YAML (часто в инфраструктурных инструментах) в JSON для использования в JavaScript-окружениях, REST API, AWS AppConfig, Azure App Configuration или других системах с JSON-конфигурациями.

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

YAML 1.2 spec через parseAllDocuments с merge:true

YAML разбирается библиотекой eemeli/yaml (v2.8+, CVE-safe) через parseAllDocuments с { version: '1.2', merge: true }. Схема YAML 1.2 гарантирует, что голые строки yes и no — строки, а не булевы. Опция merge: true полностью раскрывает merge-ключи якорей/алиасов (<<: *anchor). Многодокументный YAML возвращает первый документ.

Раскрытие якорей и алиасов библиотекой

Библиотека eemeli/yaml безопасно обрабатывает раскрытие якорей и алиасов, включая обнаружение циклических ссылок. Все алиасированные блоки данных — включая merge-ключи — полностью встроены в JSON-вывод. Это корректное преобразование, потому что у JSON нет понятия ссылок.

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

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

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

Используйте YAML 1.2-совместимый синтаксис

Пишите YAML по конвенциям YAML 1.2 — явно закавычивайте yes, no, on, off, y, n как строки (например, enabled: 'yes'), чтобы избежать неоднозначности. Инструмент разбирает по схеме YAML 1.2 (это строки), но старые инструменты в цепочке могут использовать YAML 1.1 (где это булевы). Явное закавычивание в YAML-источнике — самая безопасная практика для всех парсеров.

Закавычивайте большие числа в YAML

JavaScript не может точно представить целые больше 2^53 - 1 (9007199254740991). Поля Kubernetes вроде resourceVersion и uid — int64 на сервере и могут превышать этот лимит. В YAML-источнике закавычивайте такие значения (resourceVersion: '9007199254740993'), чтобы парсер обрабатывал их как строки, точно сохраняемые в JSON.

Проверяйте JSON-вывод перед использованием в API

После конвертации YAML в JSON проверяйте результат перед отправкой в API, сохранением или программной обработкой. Используйте наш форматировщик JSON для подтверждения корректной структуры. Особенно важно для вызовов Kubernetes API, OpenAPI-spec и любых JSON Schema-валидируемых payload.

Разделяйте многодокументный YAML перед конвертацией

Если YAML-файл содержит несколько --- разделённых документов и нужны все как JSON, сначала разделите по --- и конвертируйте каждый отдельно. Этот инструмент берёт только первый. Простой подход: разделите по '\n---\n' в редакторе или через awk, затем вставляйте каждый раздел.

Используйте jq для downstream-обработки JSON

Получив JSON из YAML, jq — самый быстрый способ запросов и трансформаций в командной строке. Скомбинируйте: конвертируйте YAML онлайн, вставьте JSON, затем jq '.spec.replicas' или jq '.services | keys' для извлечения нужного. Для batch-обработки многих файлов используйте yq CLI с флагом -o json напрямую.

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