JSON till GitHub Actions YAML

Gör om en arbetsflödesdefinition i JSON till en ren .github/workflows-fil, redo att committa.

Utdataalternativ

JSONindata

Tom

YAMLutdata

YAML-utdata visas här

Körs helt i din webbläsare: ingenting laddas upp. Gränser för rimlig användning gäller (5 MB per indata, begränsat antal konverteringar) för att förhindra spam och botar.

Läs in från URL

Filen hämtas direkt av din webbläsare, så servern måste tillåta cross-origin-förfrågningar.

Kortkommandon

Ctrl / ⌘ + Enter Konvertera nu
Ctrl / ⌘ + S Ladda ner utdata
Alt + Shift + C Kopiera utdata
Alt + Shift + F Reparera och formatera JSON-indata
Alt + Shift + S Byt riktning
Alt + Shift + T Växla mellan kod-, träd- och kartvy
Ctrl / ⌘ + Z Ångra, även Formatera, Reparera och Rensa
Esc Lämna helskärm
Textstorlek i redigeraren

Ett arbetsflöde, från JSON till YAML

Utlösare, matrix-värden, uttryck och flerradiga skript kommer ut som du själv skulle skriva dem.

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

Det här ska du hålla koll på i arbetsflödesfiler

Växla mellan konverterarens utdata och samma rader skrivna utan citattecken, och jämför hur varje YAML-version läser dem.

Nyckeln on

Ett ensamt on är true i YAML 1.1. Med citattecken, 'on', blir alla tolkar och lintrar nöjda.

Versionssträngar

Matrix-värden som '20' eller '3.10' behåller sina citattecken, så Python 3.10 blir aldrig 3.1.

Literala run-block

Strängar med radbrytningar blir run: |-block, där varje kommando står på en egen rad.

Fler verktyg

Konverterare, validerare och steg-för-steg-guider för alla ställen där JSON och YAML möts.

Vanliga frågor

Hur konverterar jag JSON till ett GitHub Actions-arbetsflöde?

Klistra in JSON i redigeraren, kopiera YAML-koden och spara den i ditt repository under .github/workflows/, till exempel .github/workflows/ci.yml. Arbetsflödet körs vid nästa matchande händelse.

Varför skrivs nyckeln on som 'on'?

I YAML 1.1 är ett ensamt on det booleska värdet true, så vissa verktyg läser utlösarnyckeln som true i stället för on. Citattecknen tar bort tvetydigheten. GitHub accepterar båda formerna, så 'on': är säkert överallt.

Behålls ${{ }}-uttryck?

Ja. Uttryck som ${{ matrix.node }} och ${{ secrets.TOKEN }} är vanliga strängar i både JSON och YAML och skrivs exakt som de står i indata.

Hur konverteras flerradiga run-skript?

En JSON-sträng med radbrytningar i form av \n blir ett literalt YAML-block (run: |), med ett kommando per rad, vilket är så arbetsflödesskript normalt skrivs.

Hur kontrollerar jag ett arbetsflöde innan jag pushar det?

Den här konverteraren kontrollerar YAML-syntaxen. För kontroller som är specifika för arbetsflöden, som okända nycklar, ogiltiga uttryck eller fel runner-etiketter, kör actionlint lokalt eller i CI.