.yaml · application/yaml

YAML: YAML 설정 및 직렬화 형식

YAML 1.2는 들여쓰기 기반의 데이터 직렬화 언어로, # 주석, 앵커 참조, 여러 줄 문자열 및 --- 구분자를 통한 다중 문서를 지원합니다.

빠른 답변: YAML 1.2는 들여쓰기 기반의 데이터 직렬화 언어로, # 주석, 앵커 참조, 여러 줄 문자열 및 --- 구분자를 통한 다중 문서를 지원합니다. Kubernetes 매니페스트, GitHub Actions 워크플로, Docker Compose 및 사람이 직접 편집하는 설정 파일.

구조 유형계층형
사람 가독성높음
중첩 지원지원
LLM 토큰 효율보통
파일 확장자.yaml
MIME 유형application/yaml
추천 용도Kubernetes 매니페스트, GitHub Actions 워크플로, Docker Compose 및 사람이 직접 편집하는 설정 파일.

장점

  • 중괄호 없이 깔끔한 여러 줄 블록과 인라인 # 주석 작성을 기본 지원
  • --- 구분자를 사용해 단일 파일 안에 여러 설정 문서를 담을 수 있음
  • JSON의 상위 호환(superset)으로 운영 매니페스트 가독성이 뛰어남

단점 및 주의사항

  • 공백 들여쓰기가 한 칸만 어긋나도 전체 구조가 조용히 망가질 수 있음
  • YAML 1.1에서는 따옴표 없는 NO나 ON 문자열이 불리언으로 오인될 수 있음
  • 앵커·별칭 등 규격이 복잡해 파서 구현 및 검증 난이도가 높음

참고 자료

YAML 로컬 변환 및 정리 도구

관련 엔지니어링 가이드

YAML 자주 묻는 질문

YAML의 '노르웨이 문제(Norway problem)'란 무엇인가요?

YAML 1.1에서 따옴표 없는 국가 코드 NO나 yes/on/off 값이 문자열이 아닌 불리언(false/true)으로 파싱되는 현상입니다. JSON으로 변환해 확인하면 안전합니다.

하나의 YAML 파일에 여러 문서를 포함할 수 있나요?

네. Kubernetes 매니페스트는 --- 줄로 리소스를 구분하는 경우가 많으며, YAML to JSON은 다중 문서 로드를 통해 JSON 배열로 변환합니다.

.yml 확장자와 .yaml 확장자 사이에 문법 차이가 있나요?

아니요. 두 확장자 모두 동일한 YAML 문법을 담고 있습니다. 공식 권장 확장자는 .yaml이며 Docker·CI 환경에서는 .yml도 흔히 쓰입니다.