on キー
YAML 1.1 では裸の on は true です。'on' と引用符で囲めば、どのパーサーやリンターでも問題ありません。
JSON のワークフロー定義を、そのままコミットできる整った .github/workflows ファイルに変換します。
出力の各行を既定の書式で表示し、その行が持つ値のパスを横に示します。行をクリックするとパスをコピーできます。
すべてブラウザ内で動作し、データはアップロードされません。スパムやボットを防ぐため、公正利用の制限(入力 1 件あたり 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: | ブロックになり、各コマンドが 1 行ずつ保たれます。
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: |)になり、1 行に 1 コマンドずつ並びます。これはワークフローのスクリプトの一般的な書き方です。
このコンバーターがチェックするのは YAML の構文です。未知のキー、無効な式、誤ったランナーラベルなど、ワークフロー固有のチェックにはローカルまたは CI で actionlint を実行してください。