JSON en YAML GitHub Actions

Transformez une définition de workflow JSON en fichier .github/workflows propre, prêt à committer.

Options de sortie

JSONentrée

Vide

YAMLsortie

La sortie YAML s'affiche ici

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.

Charger depuis une URL

Le fichier est récupéré directement par votre navigateur : le serveur doit donc autoriser les requêtes cross-origin.

Raccourcis clavier

Ctrl / ⌘ + Enter Convertir maintenant
Ctrl / ⌘ + S Télécharger la sortie
Alt + Shift + C Copier la sortie
Alt + Shift + F Réparer et formater le JSON d'entrée
Alt + Shift + S Inverser le sens
Alt + Shift + T Basculer entre les vues code, arbre et correspondance
Ctrl / ⌘ + Z Annuler, y compris Formater, Réparer et Effacer
Esc Quitter le plein écran
Taille du texte de l'éditeur

Un workflow, de JSON à YAML

Déclencheurs, valeurs de matrice, expressions et scripts multilignes sortent tels que vous les écririez à la main.

workflow.json
{
  "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"
        }
      ]
    }
  }
}
.github/workflows/ci.yml
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

Points d'attention dans les fichiers de workflow

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.

La clé on

Un on nu vaut true en YAML 1.1. L'écrire 'on', entre guillemets, satisfait tous les analyseurs et linters.

Chaînes de version

Les valeurs de matrice comme '20' ou '3.10' restent entre guillemets : Python 3.10 ne devient jamais 3.1.

Blocs run littéraux

Les chaînes contenant des sauts de ligne deviennent des blocs run: |, chaque commande restant sur sa propre ligne.

Autres outils

Convertisseurs, validateurs et guides pas à pas pour tous les endroits où JSON et YAML se croisent.

Questions fréquentes

Comment convertir du JSON en workflow GitHub Actions ?

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.

Pourquoi la clé on est-elle écrite 'on' ?

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.

Les expressions ${{ }} sont-elles conservées ?

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.

Comment les scripts run multilignes sont-ils convertis ?

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.

Comment vérifier un workflow avant de le pousser ?

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.