JSON в GitHub Actions YAML

Превратите описание рабочего процесса в JSON в чистый файл .github/workflows, готовый к коммиту.

Параметры вывода

JSONввод

Пусто

YAMLвывод

Здесь появится вывод YAML

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

Загрузка по URL

Файл запрашивается напрямую вашим браузером, поэтому сервер должен разрешать кросс-доменные запросы.

Сочетания клавиш

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 в YAML 1.1 означает true. Запись в кавычках '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. Для проверок, специфичных для рабочих процессов, например неизвестных ключей, некорректных выражений или неверных меток раннеров, запускайте actionlint локально или в CI.