La clé on
Un on nu vaut true en YAML 1.1. L'écrire 'on', entre guillemets, satisfait tous les analyseurs et linters.
Transformez une définition de workflow JSON en fichier .github/workflows propre, prêt à committer.
Chaque ligne de la sortie, en mise en forme par défaut, à côté du chemin de la valeur qu'elle contient. Cliquez sur une ligne pour copier le chemin.
Fonctionne entièrement dans votre navigateur: rien n'est envoyé. Des limites d'usage raisonnable s'appliquent (5 MB par entrée, nombre de conversions limité) pour éviter le spam et les robots.
Déclencheurs, valeurs de matrice, expressions et scripts multilignes sortent tels que vous les écririez à la main.
{
"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 Basculez entre la sortie du convertisseur et les mêmes lignes écrites sans guillemets, et comparez la façon dont chaque version de YAML les lit.
Un on nu vaut true en YAML 1.1. L'écrire 'on', entre guillemets, satisfait tous les analyseurs et linters.
Les valeurs de matrice comme '20' ou '3.10' restent entre guillemets : Python 3.10 ne devient jamais 3.1.
Les chaînes contenant des sauts de ligne deviennent des blocs run: |, chaque commande restant sur sa propre ligne.
Convertisseurs, validateurs et guides pas à pas pour tous les endroits où JSON et YAML se croisent.
Collez le JSON dans l'éditeur, copiez le YAML et enregistrez-le dans votre dépôt sous .github/workflows/, par exemple .github/workflows/ci.yml. Le workflow s'exécute au prochain événement correspondant.
En YAML 1.1, un on nu est le booléen true : certains outils lisent donc la clé de déclenchement comme true au lieu de on. Les guillemets lèvent l'ambiguïté. GitHub accepte les deux formes, donc 'on': est sûr partout.
Oui. Les expressions comme ${{ matrix.node }} et ${{ secrets.TOKEN }} sont de simples chaînes en JSON comme en YAML et sont écrites exactement comme dans l'entrée.
Une chaîne JSON contenant des sauts de ligne \n devient un bloc littéral YAML (run: |), avec une commande par ligne, ce qui correspond à la façon habituelle d'écrire les scripts de workflow.
Ce convertisseur vérifie la syntaxe YAML. Pour les contrôles propres aux workflows, comme les clés inconnues, les expressions invalides ou les mauvais libellés de runner, lancez actionlint en local ou dans la CI.