YAML JSON 변환으로 설정 파일 구조를 안전하게 옮기기

개발

문서는 YAML 예시를 주는데 실제 API는 JSON을 요구하거나, 반대로 JSON 설정을 YAML 기반 CI 파일에 넣어야 할 때가 있습니다.

이럴 때는 브라우저에서 바로 쓸 수 있는 Dante Tools를 열어 먼저 손으로 검증해보는 것이 좋습니다. 작은 확인 과정을 거치면 배포 후 되돌리는 시간을 줄일 수 있습니다.

YAML JSON 변환 사용 화면
YAML JSON 변환 사용 화면

언제 쓰면 좋은가

CI 설정, API 샘플, 인프라 옵션을 YAML과 JSON 사이에서 변환하며 구조 오류를 줄이는 방법입니다.

변환할 설정 예시

name: deploy
on:
  push:
    branches:
      - main

실무 루틴

  1. 원본 YAML 또는 JSON을 입력합니다.
  2. 들여쓰기 값을 정하고 변환합니다.
  3. 배열과 객체 구조가 의도대로 유지됐는지 확인합니다.
  4. 민감한 환경 변수 값은 실제 값 대신 placeholder로 바꿔 테스트합니다.

배포 전 체크

  • 문자열 숫자가 숫자 타입으로 바뀌어도 괜찮은가
  • 주석은 변환 과정에서 사라질 수 있음을 알고 있는가
  • CI 도구나 API가 요구하는 최상위 키 구조와 일치하는가

설정 변환은 복사 붙여넣기로 끝내면 위험합니다. 변환 후 구조를 눈으로 확인하고 실제 도구의 검증 명령까지 이어가야 합니다.

다른 글