YAML (YAML Ain't Markup Language)는 인간 친화적이고, 언어 간 데이터 직렬화 언어로, 일반적으로 구성 파일에 사용되며 데이터를 매핑, 시퀀스 및 스칼라로 표현합니다. 버전 1.2는 YAML을 JSON의 엄격한 상위 집합으로 만들었습니다. 프록시 및 스크래핑 작업에서 YAML은 구성 파일에 나타납니다. 예를 들어, Envoy 프록시의 정적 구성은 YAML로 작성되며, 트래픽이 흐르는 리스너와 클러스터를 정의합니다.

YAML 구문 기초

  • 매핑: key: value 쌍, 사전 또는 해시와 같은 형태입니다.
  • 시퀀스: 각 항목이 -로 시작하는 자체 줄에 있는 목록입니다.
  • 들여쓰기: 블록 스타일에서 들여쓰기는 구조를 결정하므로 잘못된 공백은 데이터의 의미를 변경합니다.
  • 탭 없음: 들여쓰기에 탭 문자를 사용해서는 안 됩니다.
  • 주석: #는 주석을 시작합니다.

스크래퍼 및 프록시 구성에서 YAML 안전하게 사용하기

YAML 파서는 단순한 데이터를 읽는 것 이상의 작업을 수행할 수 있습니다. PyYAML 문서는 신뢰할 수 없는 출처의 데이터에서 yaml.load를 호출하는 것은 안전하지 않다고 경고합니다. 이는 임의의 Python 객체를 구성할 수 있기 때문입니다. yaml.safe_load 함수는 표준 YAML 태그만 인식하므로 신뢰할 수 없는 입력에 대한 문서화된 선택입니다.

다중 행 문자열, 앵커 및 여러 문서

  • 리터럴 블록 (|): 다중 행 문자열에서 모든 줄 바꿈을 유지합니다.
  • 접기 블록 (>): 빈 줄이나 더 들여쓰기된 줄 앞을 제외하고 각 줄 바꿈을 공백으로 변환합니다.
  • 앵커 및 별칭: &name는 노드를 표시하고, *name는 반복하지 않고 나중에 재사용합니다.
  • 여러 문서: ---는 문서 내용의 시작을 표시하므로 하나의 스트림에 여러 문서를 포함할 수 있습니다. ...은 새 문서를 시작하지 않고 문서를 종료합니다.

관련 용어