A chave on
Um on sem aspas é true no YAML 1.1. Escrevê-lo como 'on' deixa todos os parsers e linters satisfeitos.
Transforme uma definição de workflow em JSON em um arquivo .github/workflows limpo, pronto para o commit.
Cada linha da saída, com a formatação padrão, ao lado do caminho do valor que ela contém. Clique em uma linha para copiar o caminho.
Funciona inteiramente no seu navegador: nada é enviado. Limites de uso justo se aplicam (5 MB por entrada, conversões com limite de frequência) para evitar spam e bots.
Gatilhos, valores de matriz, expressões e scripts multilinha saem do jeito que você escreveria à mão.
{
"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 Alterne entre a saída do conversor e as mesmas linhas escritas sem aspas e compare como cada versão do YAML as lê.
Um on sem aspas é true no YAML 1.1. Escrevê-lo como 'on' deixa todos os parsers e linters satisfeitos.
Valores de matriz como '20' ou '3.10' continuam entre aspas, então o Python 3.10 nunca vira 3.1.
Strings com quebras de linha viram blocos run: |, mantendo cada comando em sua própria linha.
Conversores, validadores e guias passo a passo para cada lugar onde JSON e YAML se encontram.
Cole o JSON no editor, copie o YAML e salve-o no seu repositório em .github/workflows/, por exemplo .github/workflows/ci.yml. O workflow roda no próximo evento correspondente.
No YAML 1.1, um on sem aspas é o booleano true, então algumas ferramentas leem a chave do gatilho como true em vez de on. As aspas eliminam a ambiguidade. O GitHub aceita as duas formas, então 'on': é seguro em qualquer lugar.
Sim. Expressões como ${{ matrix.node }} e ${{ secrets.TOKEN }} são strings simples tanto em JSON quanto em YAML e são escritas exatamente como aparecem na entrada.
Uma string JSON com quebras de linha \n vira um bloco literal YAML (run: |), com um comando por linha, que é como os scripts de workflow costumam ser escritos.
Este conversor verifica a sintaxe YAML. Para verificações específicas de workflow, como chaves desconhecidas, expressões inválidas ou rótulos de runner errados, rode o actionlint localmente ou no CI.