JSON към GitHub Actions YAML

Превърнете дефиниция на работен процес в JSON в чист файл за .github/workflows, готов за commit.

Опции за изхода

JSONвход

Празно

YAMLизход

Изходът YAML се появява тук

Работи изцяло във вашия браузър: нищо не се качва. Прилагат се ограничения за честна употреба (5 MB на вход, ограничен брой конвертирания) срещу спам и ботове.

Зареждане от URL

Файлът се изтегля директно от вашия браузър, затова сървърът трябва да разрешава заявки от друг произход (cross-origin).

Клавишни комбинации

Ctrl / ⌘ + Enter Конвертиране сега
Ctrl / ⌘ + S Изтегляне на изхода
Alt + Shift + C Копиране на изхода
Alt + Shift + F Поправяне и форматиране на входния JSON
Alt + Shift + S Размяна на посоката
Alt + Shift + T Превключване между изгледите код, дърво и карта
Ctrl / ⌘ + Z Отмяна, включително на „Форматирай“, „Поправи“ и „Изчисти“
Esc Изход от цял екран
Размер на текста в редактора

Работен процес от JSON към YAML

Тригерите, стойностите в matrix, изразите и многоредовите скриптове излизат така, както бихте ги написали ръчно.

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

За какво да внимавате във файловете за работни процеси

Превключвайте между изхода на конвертора и същите редове без кавички и сравнете как ги чете всяка версия на YAML.

Ключът on

Гол on е true в YAML 1.1. Записът в кавички 'on' устройва всеки парсер и линтер.

Низове за версии

Стойности в matrix като '20' или '3.10' остават в кавички, така че Python 3.10 никога не става 3.1.

Литерални run блокове

Низовете с нови редове стават блокове run: |, като всяка команда остава на собствен ред.

Още инструменти

Конвертори, валидатори и ръководства стъпка по стъпка за всяко място, където се срещат JSON и YAML.

Често задавани въпроси

Как да конвертирам JSON в GitHub Actions работен процес?

Поставете JSON в редактора, копирайте YAML и го запазете в хранилището си под .github/workflows/, например .github/workflows/ci.yml. Работният процес се изпълнява при следващото съответстващо събитие.

Защо ключът on е записан като 'on'?

В YAML 1.1 гол on е булевата стойност true, затова някои инструменти четат ключа на тригера като true вместо on. Кавичките премахват двусмислието. GitHub приема и двете форми, така че 'on': е безопасен навсякъде.

Запазват ли се изразите ${{ }}?

Да. Изрази като ${{ matrix.node }} и ${{ secrets.TOKEN }} са обикновени низове и в JSON, и в YAML и се записват точно както изглеждат във входа.

Как се конвертират многоредовите run скриптове?

JSON низ с нови редове \n става YAML литерален блок (run: |) с една команда на ред, както обикновено се пишат скриптовете в работните процеси.

Как да проверя работен процес, преди да го push-на?

Този конвертор проверява YAML синтаксиса. За проверки, специфични за работните процеси, като непознати ключове, невалидни изрази или грешни етикети на runner, изпълнете actionlint локално или в CI.