블로그

YAML을 JSON으로 변환해 공통 설정의 확장 결과 확인하기

공통 시간 제한과 재시도 횟수를 정의한 YAML을 브라우저에서 JSON으로 변환하고 상속된 값과 덮어쓴 값을 확인한다. JSON 편집 후 YAML로 되돌리는 절차와 주석·앵커 처리도 살펴본다.

영어판 YAML ⇄ JSON 변환 도구에서 공통 설정을 참조하는 YAML과 값이 확장된 JSON을 나란히 표시한 화면

공통 시간 제한은 30초, 재시도 횟수는 2회로 두고 미리 보기 환경만 재시도를 0회로 설정한다. YAML에서는 공통 설정을 참조할 수 있지만, 설정이 길어질수록 각 값의 출처를 추적하기 어려워진다. YAML ⇄ JSON 변환 도구로 JSON으로 변환하면 참조를 확장한 결과를 확인할 수 있다.

YAML의 공통 설정을 JSON으로 펼치기

왼쪽 “YAML” 입력란에 다음 예제를 붙여 넣는다. 파일을 사용할 때는 영어 화면의 “Load YAML file”에 해당하는 파일 불러오기를 선택한다. &defaults는 공통 설정에 붙인 이름이고, <<: *defaults는 해당 설정을 preview에 병합하라는 뜻이다.

# Shared request settings
defaults: &defaults
  timeoutSeconds: 30
  retries: 2
preview:
  <<: *defaults
  retries: 0

“YAML → JSON”을 누르면 오른쪽 “JSON” 입력란에 결과가 표시된다. preview.timeoutSeconds는 공통 설정을 이어받아 30이 되고, preview.retries는 개별 지정이 우선하여 0이 된다. defaults.retries는 2 그대로다.

왼쪽 YAML의 preview가 공통 설정을 참조하고 오른쪽 JSON의 preview에는 timeoutSeconds 30과 retries 0이 펼쳐진 화면
영어판 조작 예시. 오른쪽에서 preview의 최종 값을 확인할 수 있다.

JSON을 편집한 뒤 YAML로 되돌리기

  1. 오른쪽 JSON 입력란의 preview 내부에서 "timeoutSeconds": 30을 "timeoutSeconds": 10으로 바꾼다. defaults 쪽은 30으로 둔다.
  2. 오른쪽 검증 버튼을 누른다. 영어 화면에서는 “Validate: JSON → YAML → JSON”이다. 왼쪽에 새 YAML이 출력되고 입력란 아래에 검증 결과가 표시된다. 왼쪽 preview.timeoutSeconds가 10인지 확인한다.
  3. 변환 결과를 파일로 남기려면 필요한 입력란의 내용을 텍스트 편집기로 복사해 저장한다.
preview의 시간 제한을 10초로 바꾼 JSON, 변환된 YAML, 검증 성공 메시지
JSON에서 시작하는 검증은 변환된 YAML을 다시 읽고 키 순서를 제외한 데이터 구조와 값을 비교한다.

주석이나 자료형을 유지하고 싶을 때

JSON에는 원래 YAML의 주석이나 앵커 이름이 포함되지 않는다. 이 도구는 같은 페이지에서 JSON 데이터가 원래 YAML과 동등할 때 “JSON → YAML”을 누르면 보관한 원문을 돌려주는 경우가 있다. 이번 예처럼 값을 편집하면 확장된 데이터로 YAML을 새로 만든다. 주석과 공통 설정 참조를 유지하면서 시간 제한만 바꾸려면 원래 YAML의 preview에 timeoutSeconds: 10을 추가한다.

YAML에서 시작하는 “Validate: YAML → JSON → YAML” 검증은 JSON을 출력하고 YAML 원문을 보관하는 처리다. 예를 들어 limit: .nan은 검증 성공으로 표시되어도 JSON에서는 "limit": null이 된다. 자료형이 중요한 설정을 옮길 때는 변환 후의 값도 직접 확인한다.