JSON na YAML dla GitHub Actions

Zamień definicję workflow w JSON na czysty plik .github/workflows, gotowy do commita.

Opcje wyniku

JSONwejście

Pusto

YAMLwynik

Tutaj pojawi się wynik YAML

Działa w całości w przeglądarce: nic nie jest przesyłane. Obowiązują limity uczciwego użytkowania (5 MB na dane wejściowe, ograniczona liczba konwersji), aby zapobiegać spamowi i botom.

Wczytaj z adresu URL

Plik jest pobierany bezpośrednio przez przeglądarkę, więc serwer musi zezwalać na żądania cross-origin.

Skróty klawiszowe

Ctrl / ⌘ + Enter Konwertuj teraz
Ctrl / ⌘ + S Pobierz wynik
Alt + Shift + C Kopiuj wynik
Alt + Shift + F Napraw i sformatuj wejściowy JSON
Alt + Shift + S Zamień kierunek
Alt + Shift + T Przełączaj widoki: kod, drzewo i mapa
Ctrl / ⌘ + Z Cofnij, także po użyciu Formatuj, Napraw i Wyczyść
Esc Wyjdź z pełnego ekranu
Rozmiar tekstu w edytorze

Workflow: z JSON na YAML

Wyzwalacze, wartości macierzy, wyrażenia i wielowierszowe skrypty wychodzą tak, jak napisałbyś je ręcznie.

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

Na co uważać w plikach workflow

Przełączaj się między wynikiem konwertera a tymi samymi wierszami zapisanymi bez cudzysłowów i porównaj, jak odczytuje je każda wersja YAML.

Klucz on

Samo on bez cudzysłowu to w YAML 1.1 true. Zapis 'on' zadowala każdy parser i linter.

Ciągi z wersjami

Wartości macierzy, takie jak '20' czy '3.10', pozostają w cudzysłowach, więc Python 3.10 nigdy nie zmieni się w 3.1.

Literalne bloki run

Ciągi z podziałami wierszy stają się blokami run: |, a każde polecenie trafia do osobnego wiersza.

Więcej narzędzi

Konwertery, walidatory i przewodniki krok po kroku dla każdego miejsca, w którym spotykają się JSON i YAML.

Najczęściej zadawane pytania

Jak przekonwertować JSON na workflow GitHub Actions?

Wklej JSON do edytora, skopiuj YAML i zapisz go w repozytorium w katalogu .github/workflows/, na przykład jako .github/workflows/ci.yml. Workflow uruchomi się przy następnym pasującym zdarzeniu.

Dlaczego klucz on jest zapisany jako 'on'?

W YAML 1.1 samo on bez cudzysłowu to wartość logiczna true, więc niektóre narzędzia odczytują klucz wyzwalacza jako true zamiast on. Cudzysłowy usuwają tę niejednoznaczność. GitHub akceptuje obie formy, więc 'on': jest bezpieczne wszędzie.

Czy wyrażenia ${{ }} są zachowywane?

Tak. Wyrażenia takie jak ${{ matrix.node }} i ${{ secrets.TOKEN }} są zwykłymi ciągami znaków zarówno w JSON, jak i w YAML i są zapisywane dokładnie tak, jak w danych wejściowych.

Jak konwertowane są wielowierszowe skrypty run?

Ciąg JSON zawierający podziały wierszy \n staje się literalnym blokiem YAML (run: |) z jednym poleceniem w wierszu, czyli tak, jak zwykle pisze się skrypty workflow.

Jak sprawdzić workflow przed wypchnięciem?

Ten konwerter sprawdza składnię YAML. Do kontroli specyficznych dla workflow, takich jak nieznane klucze, niepoprawne wyrażenia czy błędne etykiety runnerów, uruchom actionlint lokalnie lub w CI.