Da JSON a YAML per GitHub Actions

Trasforma una definizione di workflow in JSON in un file .github/workflows pulito, pronto per il commit.

Opzioni di output

JSONinput

Vuoto

YAMLoutput

L'output YAML appare qui

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.

Carica da URL

Il file viene recuperato direttamente dal tuo browser, quindi il server deve consentire le richieste cross-origin.

Scorciatoie da tastiera

Ctrl / ⌘ + Enter Converti ora
Ctrl / ⌘ + S Scarica l'output
Alt + Shift + C Copia l'output
Alt + Shift + F Ripara e formatta il JSON di input
Alt + Shift + S Inverti la direzione
Alt + Shift + T Passa tra le viste codice, albero e mappa
Ctrl / ⌘ + Z Annulla, anche dopo Formatta, Ripara e Cancella
Esc Esci da schermo intero
Dimensione del testo nell'editor

Un workflow, da JSON a YAML

Trigger, valori della matrice, espressioni e script su più righe escono esattamente come li scriveresti a mano.

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

A cosa fare attenzione nei file di workflow

Passa dall'output del convertitore alle stesse righe scritte senza virgolette e confronta come le legge ciascuna versione di YAML.

La chiave on

Un on senza virgolette è true in YAML 1.1. Scriverlo come 'on' mette d'accordo ogni parser e linter.

Stringhe di versione

I valori della matrice come '20' o '3.10' restano tra virgolette, così Python 3.10 non diventa mai 3.1.

Blocchi run letterali

Le stringhe con a capo diventano blocchi run: |, con ogni comando sulla propria riga.

Altri strumenti

Convertitori, validatori e guide passo passo per ogni punto in cui JSON e YAML si incontrano.

Domande frequenti

Come converto JSON in un workflow GitHub Actions?

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.

Perché la chiave on è scritta come 'on'?

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.

Le espressioni ${{ }} vengono mantenute?

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.

Come vengono convertiti gli script run su più righe?

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.

Come verifico un workflow prima del push?

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.