JSON Docker Compose YAML 변환

포트와 환경 변수 값에 안전하게 따옴표를 붙여 JSON에서 유효한 compose.yaml을 생성합니다.

출력 옵션

JSON입력

비어 있음

YAML출력

YAML 출력이 여기에 표시됩니다

전부 브라우저에서 실행되며 아무것도 업로드되지 않습니다. 스팸과 봇을 막기 위해 공정 사용 제한(입력당 5 MB, 변환 횟수 제한)이 적용됩니다.

URL에서 불러오기

파일은 브라우저가 직접 가져오므로 서버가 교차 출처 요청을 허용해야 합니다.

키보드 단축키

Ctrl / ⌘ + Enter 지금 변환
Ctrl / ⌘ + S 출력 다운로드
Alt + Shift + C 출력 복사
Alt + Shift + F JSON 입력 수정 및 정렬
Alt + Shift + S 방향 전환
Alt + Shift + T 코드, 트리, 맵 보기 전환
Ctrl / ⌘ + Z 실행 취소 (정렬, 수정, 지우기 포함)
Esc 전체 화면 종료
편집기 글자 크기

포트와 환경 변수 값에 안전하게 따옴표

Compose 파일은 YAML 1.1 파서로 읽히며, 여기서 22:22는 60진수이고 NO는 false입니다. 모호한 문자열에는 모두 따옴표를 붙이므로 서비스는 작성한 값 그대로 시작됩니다.

JSON
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": [
        "80:80",
        "22:22"
      ],
      "environment": {
        "DEBUG": "false",
        "WORKERS": "4",
        "COUNTRY": "NO"
      }
    }
  }
}
compose.yaml
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
      - '22:22'
    environment:
      DEBUG: 'false'
      WORKERS: '4'
      COUNTRY: 'NO'

Compose 파일에서는 YAML 1.1 호환을 켜 두세요. 위에서 이 옵션을 끄면 22:22가 따옴표 없이 작성되고 YAML 1.1 파서가 이를 어떻게 해석하는지 볼 수 있습니다.

Docker로 결과 확인

docker compose config는 파일을 검사하고 최종 모델을 출력하며, 이 모델을 JSON으로도 출력할 수 있습니다.

bash
# Validate a compose file and print the fully resolved model
docker compose config

# The same model as JSON, e.g. to inspect it with jq
docker compose config --format json | jq '.services | keys'

Compose 팁

compose.yaml 사용

권장되는 파일 이름입니다. 오래된 프로젝트에서는 docker-compose.yml도 여전히 동작합니다.

version 키 삭제

최상위 version 필드는 더 이상 사용되지 않습니다. 현재 Docker Compose는 이를 무시하고 경고를 출력합니다.

env는 목록 또는 맵으로

environment는 맵(KEY: value)이나 목록(- KEY=value)을 받습니다. JSON 객체에서 만든 맵이 더 읽기 쉽습니다.

더 많은 도구

JSON과 YAML이 만나는 모든 곳을 위한 변환기, 검사기, 단계별 가이드.

자주 묻는 질문

JSON을 Docker Compose 파일로 어떻게 변환하나요?

JSON을 편집기에 붙여넣고 오른쪽의 YAML을 compose.yaml에 복사하세요. 최상위 services, volumes, networks 키는 유지한 다음, docker compose config를 실행해 결과를 확인하세요.

"80:80" 같은 포트 매핑에 따옴표가 붙는 이유는 무엇인가요?

YAML 1.1 파서는 22:22처럼 콜론으로 구분된 따옴표 없는 숫자를 60진수 정수로 읽습니다. Docker는 포트 매핑에 항상 따옴표를 붙일 것을 권장하며, 'YAML 1.1 호환'이 켜져 있으면 변환기가 자동으로 처리합니다.

파일 이름은 compose.yaml과 docker-compose.yml 중 무엇으로 해야 하나요?

현재 Compose 사양에서는 compose.yaml이 권장 이름입니다. docker-compose.yml과 docker-compose.yaml도 하위 호환성을 위해 계속 읽힙니다.

version 키가 아직 필요한가요?

아니요. 최상위 version 키는 Compose 사양에서 더 이상 사용되지 않으며, Docker Compose는 경고를 출력하고 이를 무시합니다. 생략해도 됩니다.

Compose 파일을 다시 JSON으로 변환할 수 있나요?

네. 변환 방향을 YAML → JSON으로 바꾸거나, docker compose config --format json을 실행하세요. 이 명령은 변수, extends, profiles도 해석합니다.