on 키
YAML 1.1에서 따옴표 없는 on은 true입니다. 'on'으로 따옴표를 붙이면 모든 파서와 린터에서 문제가 없습니다.
JSON 워크플로 정의를 바로 커밋할 수 있는 깔끔한 .github/workflows 파일로 변환합니다.
출력의 각 줄을 기본 서식으로 보여 주고, 그 줄에 담긴 값의 경로를 옆에 표시합니다. 줄을 클릭하면 경로가 복사됩니다.
전부 브라우저에서 실행되며 아무것도 업로드되지 않습니다. 스팸과 봇을 막기 위해 공정 사용 제한(입력당 5 MB, 변환 횟수 제한)이 적용됩니다.
트리거, matrix 값, 표현식, 여러 줄 스크립트가 모두 직접 작성한 것과 같은 모양으로 출력됩니다.
{
"name": "CI",
"on": {
"push": {
"branches": [
"main"
]
}
},
"jobs": {
"test": {
"runs-on": "ubuntu-latest",
"strategy": {
"matrix": {
"node": [
"20",
"22"
]
}
},
"steps": [
{
"uses": "actions/checkout@v4"
},
{
"uses": "actions/setup-node@v4",
"with": {
"node-version": "${{ matrix.node }}"
}
},
{
"run": "npm ci\nnpm test\n"
}
]
}
}
} name: CI
'on':
push:
branches:
- main
jobs:
test:
runs-on: ubuntu-latest
strategy:
matrix:
node:
- '20'
- '22'
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: ${{ matrix.node }}
- run: |
npm ci
npm test 변환기의 출력과 같은 줄을 따옴표 없이 작성한 경우를 전환하면서 각 YAML 버전이 어떻게 읽는지 비교해 보세요.
YAML 1.1에서 따옴표 없는 on은 true입니다. 'on'으로 따옴표를 붙이면 모든 파서와 린터에서 문제가 없습니다.
'20'이나 '3.10' 같은 matrix 값은 따옴표가 유지되므로 Python 3.10이 3.1로 바뀌지 않습니다.
줄바꿈이 있는 문자열은 run: | 블록이 되어 각 명령이 한 줄씩 유지됩니다.
JSON과 YAML이 만나는 모든 곳을 위한 변환기, 검사기, 단계별 가이드.
JSON을 편집기에 붙여넣고 YAML을 복사한 뒤 저장소의 .github/workflows/ 아래(예: .github/workflows/ci.yml)에 저장하세요. 워크플로는 다음에 일치하는 이벤트가 발생하면 실행됩니다.
YAML 1.1에서 따옴표 없는 on은 불리언 true이므로, 일부 도구는 트리거 키를 on이 아닌 true로 읽습니다. 따옴표를 붙이면 모호함이 사라집니다. GitHub는 두 형식을 모두 허용하므로 'on':은 어디서나 안전합니다.
네. ${{ matrix.node }}와 ${{ secrets.TOKEN }} 같은 표현식은 JSON과 YAML 모두에서 일반 문자열이며, 입력에 있는 그대로 작성됩니다.
\n 줄바꿈이 포함된 JSON 문자열은 YAML 리터럴 블록(run: |)이 되어 한 줄에 명령 하나씩 놓입니다. 워크플로 스크립트를 작성하는 일반적인 방식입니다.
이 변환기는 YAML 구문을 검사합니다. 알 수 없는 키, 잘못된 표현식, 틀린 러너 레이블 같은 워크플로 전용 검사는 로컬이나 CI에서 actionlint를 실행하세요.