JSON을 들여쓰기 기반의 YAML로 바꿔 줍니다. 괄호와 따옴표가 빠지니 사람이 직접 고치는 설정 파일로 쓰기 좋은 모양이 되고, 키 순서는 원래 JSON 그대로 유지됩니다.
kubectl get -o json으로 받은 리소스를 매니페스트로 옮기거나, API로 받은 설정을 docker-compose.yml·application.yml·GitHub Actions 워크플로에 붙여넣을 때 유용합니다.
JSON 칸에 변환할 JSON을 붙여넣습니다. 문법이 틀리면 결과 칸에 JSON parsing failed가 나오니 먼저 JSON 검증기로 확인하세요.결과 칸의 YAML을 확인합니다. 들여쓰기는 공백 2칸입니다.{
"services": {
"web": {
"image": "nginx:1.27",
"ports": ["8080:80"],
"environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
}
}
}services:
web:
image: nginx:1.27
ports:
- 8080:80
environment:
FEATURE_FLAG: "on"
GREETING: |-
hello
world
문자열 "on"은 따옴표가 붙은 채로 나왔습니다. 따옴표 없이 on이라고 쓰면 YAML 1.1 파서는 불리언 true로 읽기 때문입니다. 줄바꿈이 있는 GREETING은 |- 블록으로 바뀌어 여러 줄 그대로 보입니다.
yes, no, on, off, y, n, ~, null 같은 문자열과 "0777", "1.0", "2024-01-01"처럼 숫자·날짜로 오해될 값을 감싸서 PyYAML(1.1)과 최신 1.2 파서 모두 같은 값으로 읽게 합니다.22:22처럼 YAML 1.1에서 60진수로 읽힐 수 있는 문자열도 따옴표로 감쌉니다. docker-compose 포트 매핑에서 흔히 생기는 사고를 막아 줍니다.|- 리터럴 블록으로 씁니다.[], {}로 남깁니다.클러스터에서 JSON으로 꺼낸 Deployment·ConfigMap을 YAML로 바꾼 뒤 status, metadata.uid 같은 필드만 지우면 Git에 올릴 매니페스트가 됩니다.
설정 서버나 문서에서 JSON으로 받은 프로퍼티 묶음을 YAML 계층 구조로 바꾸면 spring.datasource.url 같은 키를 일일이 들여쓰지 않아도 됩니다.
&)·별칭(*)은 만들지 않습니다. JSON에 같은 객체가 반복돼도 YAML에 그대로 반복됩니다.---로 나눈 파일이 필요하면 리소스마다 변환해 직접 이어 붙이세요.따옴표가 없으면 다른 타입으로 읽힐 값에만 붙입니다. nginx:1.27은 그대로 둬도 문자열이지만 on, 010, 22:22는 파서에 따라 불리언·숫자로 바뀌므로 감쌉니다.
구조는 그대로 쓸 수 있습니다. 다만 kubectl get -o json 결과에는 status, resourceVersion, managedFields 같은 서버가 채운 필드가 있으니 apply 전에 지우는 것이 좋습니다.
옵션은 없고 2칸으로 고정입니다. Kubernetes, docker-compose, GitHub Actions 문서가 모두 2칸을 쓰기 때문에 그 관례를 따랐습니다.