La chiave on
Un on senza virgolette è true in YAML 1.1. Scriverlo come 'on' mette d'accordo ogni parser e linter.
Trasforma una definizione di workflow in JSON in un file .github/workflows pulito, pronto per il commit.
Ogni riga dell'output, con la formattazione predefinita, accanto al percorso del valore che contiene. Fai clic su una riga per copiare il percorso.
Funziona interamente nel tuo browser: nulla viene caricato. Si applicano limiti di uso corretto (5 MB per input, numero di conversioni limitato) per prevenire spam e bot.
Trigger, valori della matrice, espressioni e script su più righe escono esattamente come li scriveresti a mano.
{
"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 Passa dall'output del convertitore alle stesse righe scritte senza virgolette e confronta come le legge ciascuna versione di YAML.
Un on senza virgolette è true in YAML 1.1. Scriverlo come 'on' mette d'accordo ogni parser e linter.
I valori della matrice come '20' o '3.10' restano tra virgolette, così Python 3.10 non diventa mai 3.1.
Le stringhe con a capo diventano blocchi run: |, con ogni comando sulla propria riga.
Convertitori, validatori e guide passo passo per ogni punto in cui JSON e YAML si incontrano.
Incolla il JSON nell'editor, copia lo YAML e salvalo nel repository sotto .github/workflows/, ad esempio .github/workflows/ci.yml. Il workflow parte al successivo evento corrispondente.
In YAML 1.1 un on senza virgolette è il booleano true, quindi alcuni strumenti leggono la chiave del trigger come true invece che come on. Le virgolette eliminano l'ambiguità. GitHub accetta entrambe le forme, quindi 'on': è sicuro ovunque.
Sì. Espressioni come ${{ matrix.node }} e ${{ secrets.TOKEN }} sono semplici stringhe sia in JSON sia in YAML e vengono scritte esattamente come appaiono nell'input.
Una stringa JSON che contiene a capo \n diventa un blocco letterale YAML (run: |), con un comando per riga, che è il modo in cui si scrivono normalmente gli script dei workflow.
Questo convertitore controlla la sintassi YAML. Per i controlli specifici dei workflow, come chiavi sconosciute, espressioni non valide o etichette di runner errate, esegui actionlint in locale o in CI.