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

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

2. 2

   실시간 YAML 출력 확인

   YAML이 출력 패널에 즉시 표시됩니다. 대상 도구의 요구 사항에 맞게 옵션(들여쓰기 2/4칸, 인용 자동/큰따옴표/작은따옴표, 스타일 블록/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 매니페스트

kubectl get -o json 또는 Kubernetes API에서 받은 JSON API 응답을 GitOps 워크플로, Kustomize 오버레이, kubectl apply -f 배포용 YAML 매니페스트로 변환합니다.

Docker Compose 파일

docker inspect JSON 출력 또는 프로그래밍 방식으로 생성된 서비스 설정을 docker compose up 및 Docker Stack 배포와 호환되는 docker-compose.yaml 파일로 변환합니다.

Helm 차트 Values

JSON 설정 내보내기를 Helm 차트 배포용 YAML values 파일로 변환하여 깔끔한 YAML 구문으로 버전 관리된 인프라 설정을 구현합니다.

GitHub Actions 워크플로

JSON으로 GitHub Actions 워크플로 정의를 프로그래밍 방식으로 구축한 후 GitHub Actions 러너가 요구하는 .github/workflows/*.yaml 형식으로 변환합니다.

OpenAPI 명세

많은 프레임워크(FastAPI, SpringDoc)가 반환하는 JSON 형식의 OpenAPI/Swagger 명세를 Swagger UI, Redoc, API 게이트웨이 도구에서 선호하는 YAML 형식으로 변환합니다.

설정 마이그레이션

JSON에 저장된 애플리케이션 설정(appsettings.json, config.json)을 YAML이 필요하거나 선호하는 도구용 YAML 형식으로 마이그레이션하여 주석으로 문서화할 수 있습니다.

기술 세부 정보

RFC 8259 호환 JSON 파싱

JSON 입력은 브라우저의 네이티브 JSON.parse()를 사용하여 파싱되며 RFC 8259를 완전히 준수합니다. 위치 정보(최선의 줄 및 열 번호)를 포함한 정확한 구문 오류 메시지를 제공하며 모든 JSON 데이터 타입(문자열, 숫자, 불리언, null, 배열, 객체)을 처리합니다.

YAML 1.1 스키마를 사용하는 eemeli/yaml Document API를 통한 YAML 1.2 출력

YAML은 eemeli/yaml 라이브러리(v2.8+, CVE 안전)를 통해 version: '1.1'로 Document API를 사용하여 생성됩니다. 이 조합은 YAML 1.2 호환 출력을 생성하면서 YAML 1.1 인용 규칙을 적용합니다 — Norway 문제 문자열(yes/no/on/off/y/n)이 출력에서 자동으로 인용되어 YAML 1.1 및 1.2 파서 모두에서 안전합니다. 긴 문자열을 온전히 유지하기 위해 줄 바꿈이 비활성화됩니다(lineWidth: 0).

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

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

모범 사례

DevOps 설정에는 항상 자동 인용 모드 사용

Kubernetes, Helm, Ansible, Docker Compose, GitHub Actions에서 사용할 JSON을 변환할 때는 항상 기본 자동(Norway 안전) 인용 모드를 사용하세요. 이러한 도구의 YAML 1.1 파서는 단순 문자열 yes, no, on, off, y, n을 불리언으로 잘못 해석합니다 — 자동 모드가 이를 투명하게 방지합니다.

클라우드 네이티브 도구에는 2칸 들여쓰기 사용

Kubernetes, Docker Compose, GitHub Actions, Helm은 관례적으로 2칸 들여쓰기를 사용합니다. 이러한 파일에서 4칸 들여쓰기를 사용하는 것은 유효한 YAML이지만 커뮤니티 예시, 자동 생성된 설정, 팀의 기존 매니페스트와 불일치를 만들 수 있습니다.

변환 전 큰 정수를 문자열로 저장

API 서버의 Kubernetes resourceVersion, uid, 기타 int64 필드는 자바스크립트의 안전한 정수 범위(2^53 - 1)를 초과할 수 있습니다. 정확한 수치 정밀도가 필요하다면 변환 전에 이 값들을 JSON 문자열로 저장하세요. 서버 측 생성 필드가 포함된 kubectl get -o json 출력에 특히 중요합니다.

먼저 JSON 유효성 검사

JSON 소스가 직접 작성되었거나 유효하지 않은 출력을 가끔 생성하는 시스템(후행 쉼표, 인용되지 않은 키, 주석)에서 온 경우 변환 전에 JSON 포맷터로 유효성을 검사하세요. JSON 포맷터를 사용하여 먼저 구문 오류를 찾아 수정한 다음 깨끗한 JSON을 YAML로 변환하세요.

버전 관리에 들어가는 파일에는 블록 스타일 선호

블록 스타일 YAML은 각 필드가 별도 줄에 표시되기 때문에 Git에서 사람이 읽기 쉬운 diff를 생성합니다. Flow 스타일(컴팩트한 인라인)은 diff를 읽고 검토하기 어렵게 만듭니다. Flow 스타일은 문서에 짧은 YAML 스니펫을 삽입하거나 컴팩트한 출력이 필요한 도구에 한해 사용하세요.

자주 묻는 질문