JSON to YAML 변환기

JSON을 YAML로 변환하는 이유

JSON은 기계와 API에 적합하지만, YAML은 중괄호도 필수 따옴표도 없고 주석을 지원해 사람이 읽고 수정하기 쉽습니다. Kubernetes, Helm, Docker Compose, GitHub Actions, GitLab CI, Ansible 등 대부분의 인프라 도구는 YAML로 설정하지만, 출발점이 되는 데이터(API 출력, kubectl get -o json, Terraform state)는 JSON인 경우가 많습니다.

블록 스타일과 플로우 스타일

블록 스타일은 각 키와 목록 항목을 한 줄씩 두며 설정 파일의 관례적인 선택입니다. 플로우 스타일은 JSON처럼 인라인 {}와 []를 사용해 짧은 말단 구조를 간결하게 유지합니다. “레벨 2부터 플로우”는 상위 두 단계를 블록 스타일로 두고 그보다 깊은 부분을 인라인으로 만들어, 포트나 환경 변수처럼 작은 객체가 길게 나열된 목록에 잘 맞습니다.

안전한 따옴표 처리

YAML 파서가 잘못 해석할 수 있는 문자열은 자동으로 따옴표로 감쌉니다. 'no', 'on', '1.0', 'null' 같은 값, *나 &로 시작하는 문자열, : 를 포함한 문자열이 해당합니다. 스타일 가이드가 모든 문자열에 따옴표를 요구한다면 항상 작은따옴표 또는 항상 큰따옴표를 선택하세요.

YAML 1.1과 1.2의 함정

이 변환기는 현재 명세인 YAML 1.2를 따릅니다. 하지만 많은 오래된 도구(PyYAML, Ruby의 Psych, 일부 Kubernetes·Ansible 버전)는 아직 규칙이 다른 YAML 1.1로 읽습니다.

• 노르웨이 문제: YAML 1.1에서 country: no는 false를 뜻하므로 노르웨이 국가 코드 NO가 사라집니다. yes, on, off, y, n도 마찬가지입니다. YAML 1.2는 true와 false만 불리언으로 취급합니다.
• 8진수: 0755는 1.1에서는 8진수지만 1.2에서는 일반 10진수이며, 1.2는 0o755를 씁니다. 파일 권한은 안전하게 따옴표로 감싸세요.
• 60진수: 1.1에서는 22:30이 숫자 1350으로 파싱될 수 있습니다. 시간과 "8080:80" 같은 포트 매핑은 따옴표로 감싸세요.

JSON → YAML 방향에서는 모호한 문자열('no', 'on', 'y')을 자동으로 따옴표 처리하므로, 생성된 YAML은 두 버전에서 똑같이 읽힙니다.