JSON zu GitHub Actions-YAML

Eine JSON-Workflow-Definition in eine saubere .github/workflows-Datei umwandeln, bereit zum Committen.

Ausgabeoptionen

JSONEingabe

Leer

YAMLAusgabe

Die YAML-Ausgabe erscheint hier

Läuft vollständig in Ihrem Browser: nichts wird hochgeladen. Es gelten Fair-Use-Limits (5 MB pro Eingabe, begrenzte Anzahl an Konvertierungen), um Spam und Bots zu verhindern.

Von URL laden

Die Datei wird direkt von Ihrem Browser abgerufen, daher muss der Server Cross-Origin-Anfragen zulassen.

Tastenkürzel

Ctrl / ⌘ + Enter Jetzt konvertieren
Ctrl / ⌘ + S Ausgabe herunterladen
Alt + Shift + C Ausgabe kopieren
Alt + Shift + F JSON-Eingabe reparieren und formatieren
Alt + Shift + S Richtung umkehren
Alt + Shift + T Zwischen Code-, Baum- und Zuordnungsansicht wechseln
Ctrl / ⌘ + Z Rückgängig, auch nach Formatieren, Reparieren und Leeren
Esc Vollbild verlassen
Textgröße im Editor

Ein Workflow, von JSON zu YAML

Trigger, Matrix-Werte, Ausdrücke und mehrzeilige Skripte sehen genau so aus, wie Sie sie von Hand schreiben würden.

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

Worauf Sie bei Workflow-Dateien achten sollten

Wechseln Sie zwischen der Ausgabe des Konverters und denselben Zeilen ohne Anführungszeichen und vergleichen Sie, wie jede YAML-Version sie liest.

Der Schlüssel on

Ein nacktes on ist in YAML 1.1 true. In Anführungszeichen als 'on' sind alle Parser und Linter zufrieden.

Versionszeichenketten

Matrix-Werte wie '20' oder '3.10' bleiben in Anführungszeichen, sodass Python 3.10 nie zu 3.1 wird.

Literal-Blöcke für run

Zeichenketten mit Zeilenumbrüchen werden zu run: |-Blöcken, und jeder Befehl bleibt in seiner eigenen Zeile.

Weitere Tools

Konverter, Validatoren und Schritt-für-Schritt-Anleitungen für alle Stellen, an denen JSON und YAML aufeinandertreffen.

Häufig gestellte Fragen

Wie konvertiere ich JSON in einen GitHub Actions-Workflow?

Fügen Sie das JSON in den Editor ein, kopieren Sie das YAML und speichern Sie es in Ihrem Repository unter .github/workflows/, zum Beispiel als .github/workflows/ci.yml. Der Workflow läuft beim nächsten passenden Ereignis.

Warum wird der Schlüssel on als 'on' geschrieben?

In YAML 1.1 ist ein nacktes on der Boolean-Wert true, daher lesen manche Tools den Trigger-Schlüssel als true statt als on. Die Anführungszeichen beseitigen die Mehrdeutigkeit. GitHub akzeptiert beide Formen, also ist 'on': überall sicher.

Bleiben ${{ }}-Ausdrücke erhalten?

Ja. Ausdrücke wie ${{ matrix.node }} und ${{ secrets.TOKEN }} sind in JSON wie in YAML einfache Zeichenketten und werden genau so geschrieben, wie sie in der Eingabe stehen.

Wie werden mehrzeilige run-Skripte konvertiert?

Eine JSON-Zeichenkette mit \n-Zeilenumbrüchen wird zu einem YAML-Literal-Block (run: |) mit einem Befehl pro Zeile, so wie Workflow-Skripte üblicherweise geschrieben werden.

Wie prüfe ich einen Workflow, bevor ich ihn pushe?

Dieser Konverter prüft die YAML-Syntax. Für workflow-spezifische Prüfungen wie unbekannte Schlüssel, ungültige Ausdrücke oder falsche Runner-Labels führen Sie actionlint lokal oder in der CI aus.