YAML to JSON 변환기 (YAML to JSON Converter)

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 데이터를 입력하거나 붙여넣으세요. '예시 불러오기'를 클릭하여 Kubernetes Deployment, Docker Compose 파일, Helm values.yaml 같은 샘플을 사용해 볼 수도 있습니다.

2. 2

   실시간 JSON 출력 확인

   JSON이 출력 패널에 즉시 표시됩니다. 대상 도구의 요구 사항에 맞게 옵션(들여쓰기 2칸 또는 4칸)을 조정하세요.

3. 3

   복사 또는 다운로드

   복사를 클릭하여 JSON을 클립보드에 저장하거나 다운로드를 클릭하여 .json 파일로 저장하면 jq, API 호출, 기타 다운스트림 도구에서 바로 사용할 수 있습니다.

일반적인 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 매니페스트 분석

Kubernetes YAML 매니페스트를 JSON으로 변환하여 jq로 쿼리하거나, Kubernetes REST API로 전송하거나, Terraform 데이터 소스에서 처리하거나, JSON을 기대하는 CI/CD 파이프라인에 입력합니다.

Docker Compose에서 자바스크립트 도구로

Docker Compose YAML을 JSON으로 파싱하여 자동화 스크립트, 의존성 그래프, Node.js 도구에서 사용할 서비스 정의, 이미지 이름, 포트 매핑, 환경 변수를 추출합니다.

GitHub Actions API 통합

GitHub Actions 워크플로 YAML을 JSON으로 변환하여 구조를 프로그래밍 방식으로 검증하거나, job 및 step 정의를 추출하거나, JSON 워크플로 명세를 허용하는 CI/CD API와 통합합니다.

OpenAPI에서 클라이언트 코드 생성으로

많은 코드 생성기(openapi-generator, swagger-codegen, oazapfts)는 두 형식의 OpenAPI 명세를 허용합니다. 도구가 특히 JSON 입력을 요구하거나 JSON Schema 검증기로 검사해야 할 때 YAML 명세를 JSON으로 변환하세요.

Helm Values 분석

Helm 차트 values.yaml을 JSON으로 변환하여 보고서를 생성하거나, 환경 간 values를 비교하거나, 정책 적용 도구에 입력하거나, JSON 설정을 기대하는 자동화로 처리합니다.

JSON 기반 도구로 설정 마이그레이션

애플리케이션 설정을 인프라 도구에서 일반적인 YAML에서 자바스크립트 환경, REST API, AWS AppConfig, Azure App Configuration, JSON으로 설정을 저장하는 모든 시스템용 JSON으로 마이그레이션합니다.

기술 세부 정보

merge:true로 parseAllDocuments를 통한 YAML 1.2 명세

YAML은 eemeli/yaml 라이브러리(v2.8+, CVE 안전)를 통해 { version: '1.2', merge: true }로 parseAllDocuments를 사용하여 파싱됩니다. YAML 1.2 스키마는 yes와 no 같은 단순 문자열이 현재 YAML 명세와 일치하여 불리언이 아닌 문자열로 처리되도록 합니다. merge: true 옵션은 앵커/별칭 병합 키(<<: *anchor)를 완전히 확장하여 JSON 출력에 완전한 역참조 데이터가 포함되도록 합니다. 다중 문서 YAML(--- 구분)은 첫 번째 문서를 반환합니다.

라이브러리를 통한 앵커와 별칭 확장

eemeli/yaml 라이브러리는 순환 참조 감지를 포함하여 앵커(&name)와 별칭(*name) 확장을 안전하게 처리합니다. 모든 참조된 데이터 블록(병합 키 확장 포함)이 JSON 출력에 완전히 인라인됩니다. JSON에는 참조나 앵커 개념이 없으므로 이것이 올바른 변환입니다. 라이브러리의 안전한 확장은 잘못된 형식의 YAML로 인한 무한 루프를 방지합니다.

브라우저 기반 — 업로드 없음, 서버 없음

모든 처리는 브라우저의 자바스크립트 엔진에서 완전히 실행됩니다. 어떤 시점에서도 네트워크를 통해 데이터가 전송되지 않습니다. 200KB보다 큰 입력은 자동으로 실시간 모드에서 수동 모드(명시적인 변환 클릭 필요)로 전환되어 브라우저 응답성을 유지하고 무거운 직렬화 중 메인 스레드 블로킹을 방지합니다.

모범 사례

깔끔한 변환을 위해 YAML 1.2 호환 구문 사용

YAML 1.2 관례를 사용하여 YAML을 작성하세요 — 모호함을 피하기 위해 yes, no, on, off, y, n 문자열 값을 명시적으로 인용하세요(예: enabled: 'yes'). 이 도구는 YAML 1.2 스키마로 파싱(이것들은 문자열)하지만 파이프라인의 구버전 도구는 YAML 1.1을 사용(불리언으로 처리)할 수 있습니다. 소스 YAML에서 명시적으로 인용하는 것이 모든 파서에서 가장 안전한 방법입니다.

정밀도 유지를 위해 YAML에서 큰 숫자 인용

자바스크립트는 2^53 - 1(9007199254740991)보다 큰 정수를 정확히 표현할 수 없습니다. Kubernetes의 resourceVersion과 uid 같은 필드는 서버에서 int64이며 이 한계를 초과할 수 있습니다. YAML 소스에서 이 값들을 인용하면(resourceVersion: '9007199254740993') 파서가 문자열로 처리하여 JSON 출력에서 문자열 값으로 정확히 유지됩니다.

API에서 사용하기 전 JSON 출력 유효성 검사

YAML을 JSON으로 변환한 후 API로 전송하거나, 저장하거나, 프로그래밍 방식으로 처리하기 전에 결과를 검증하세요. JSON 포맷터를 사용하여 구조가 올바른지 확인하세요. 이것은 Kubernetes API 호출, OpenAPI 명세, JSON Schema 검증 페이로드에서 특히 중요하며 구조 오류는 변환 단계가 아닌 API 계층에서 혼란스러운 거부를 유발합니다.

변환 전 다중 문서 YAML 분리

YAML 파일에 여러 --- 구분 문서가 있고 모두 JSON으로 변환해야 한다면 먼저 파일을 ---로 분할한 후 각 문서를 개별적으로 변환하세요. 이 도구는 첫 번째 문서만 처리합니다. 간단한 방법: 편집기에서 '\n---\n'으로 분할하거나 awk를 사용한 후 각 섹션을 개별적으로 붙여넣으세요.

다운스트림 JSON 처리에 jq 사용

YAML에서 JSON을 얻은 후 jq는 명령줄에서 가장 빠르게 쿼리하고 변환하는 방법입니다. 이 도구와 jq를 조합하세요: 온라인으로 YAML을 변환하고, JSON을 붙여넣은 후, jq '.spec.replicas' 또는 jq '.services | keys'로 정확히 필요한 내용을 추출합니다. 많은 파일을 일괄 처리하려면 -o json 플래그와 함께 yq CLI를 직접 사용하세요.

자주 묻는 질문