YAML(yml) 문서를 JSON으로 바꿔서 들여쓰기에 가려진 실제 구조와 값의 타입을 확인할 수 있게 해 줍니다. 앵커와 별칭은 실제 값으로 풀어서 보여 주고, ---로 나뉜 여러 문서는 배열로 묶습니다.
들여쓰기 한 칸 차이로 값이 엉뚱한 곳에 붙었는지, version: 1.10이 숫자 1.1로 바뀌지 않았는지처럼 YAML에서 자주 생기는 실수를 찾을 때 특히 쓸모가 있습니다.
YAML 칸에 docker-compose.yml, Kubernetes 매니페스트, 워크플로 파일 등을 붙여넣거나 파일을 끌어다 놓습니다.결과 칸의 JSON에서 각 값이 문자열·숫자·불리언 중 무엇으로 읽혔는지 확인하고 필요하면 복사합니다.name: ci
on:
push:
branches: [main]
defaults: &node
runs-on: ubuntu-latest
timeout-minutes: 10
jobs:
test: *node
{
"name": "ci",
"on": {
"push": {
"branches": [
"main"
]
}
},
"defaults": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
},
"jobs": {
"test": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
}
}
}GitHub Actions 워크플로의 on: 키가 문자열 키 "on"으로 남았습니다. 이 도구는 YAML 1.2 규칙으로 읽기 때문입니다. &node 앵커로 정의한 블록은 *node 자리에 실제 값으로 펼쳐졌습니다.
yes, on, off는 문자열로 남고 true/True/false만 불리언이 됩니다.~와 빈 값은 null, 0x1F(16진수)와 0o17(8진수)은 숫자로 바뀝니다.&앵커와 *별칭은 참조된 값으로 풀어서 출력합니다.| 리터럴과 > 접힌 블록 문자열을 YAML 규칙대로 줄바꿈을 처리해 문자열로 만듭니다.---로 구분된 여러 문서는 JSON 배열로, 문서가 하나면 그 값 그대로 출력합니다.containers 아래 env가 한 칸 덜 들여써져 다른 필드에 붙어 있으면 apply 단계에서야 알게 됩니다. JSON으로 바꾸면 어떤 객체에 속했는지 괄호로 바로 보입니다.
YAML 파서를 추가하기 애매한 스크립트나 프론트엔드 코드에 설정을 넣을 때, JSON으로 바꿔 import config from './config.json'처럼 쓸 수 있습니다.
YAML로 작성된 OpenAPI 문서를 JSON으로 바꾸면 JSONPath나 jq로 특정 경로의 스키마를 뽑아 보기 쉬워집니다.
<<: *기본값은 펼쳐서 적용합니다. 앵커의 키가 복사되고, << 옆에 직접 쓴 키가 있으면 그 값이 우선합니다. YAML 1.2만 따르는 파서는 <<를 일반 키로 남기므로 그런 도구와 결과가 다를 수 있습니다.2024-01-01)은 Date로 바뀌지 않고 문자열로 남습니다..inf, .nan은 JSON에 표현할 수 없어 null이 됩니다.on, yes를 true로 읽으므로 Python에서 읽는 결과와 다를 수 있습니다.on이 왜 true가 아니라 "on"인가요?YAML 1.2에서 불리언은 true/false뿐이라 on은 평범한 문자열입니다. GitHub Actions도 on을 키 이름으로 읽습니다. 반면 Python의 PyYAML은 1.1 규칙을 써서 True 키로 바꿔 버리니 스크립트에서 워크플로를 읽을 때 주의하세요.
version: 1.10이 1.1로 나와요.YAML에서 따옴표 없는 1.10은 숫자이고, 숫자 1.10과 1.1은 같은 값입니다. 버전 문자열을 유지하려면 원본 YAML에서 "1.10"처럼 따옴표로 감싸야 합니다.
---로 나뉜 문서 순서대로 배열 요소가 됩니다. kubectl apply -f에 쓰는 여러 리소스 파일을 넣으면 리소스 배열을 얻을 수 있습니다.