JSON'dan GitHub Actions YAML'a

JSON iş akışı tanımını commit'e hazır, temiz bir .github/workflows dosyasına çevirin.

Çıktı seçenekleri

JSONgirdi

Boş

YAMLçıktı

YAML çıktısı burada görünür

Tamamen tarayıcınızda çalışır: hiçbir şey yüklenmez. Spam ve botları önlemek için adil kullanım sınırları geçerlidir (girdi başına 5 MB, hız sınırlı dönüştürmeler).

URL'den yükle

Dosya doğrudan tarayıcınız tarafından alınır; bu nedenle sunucunun çapraz kaynaklı isteklere izin vermesi gerekir.

Klavye kısayolları

Ctrl / ⌘ + Enter Şimdi dönüştür
Ctrl / ⌘ + S Çıktıyı indir
Alt + Shift + C Çıktıyı kopyala
Alt + Shift + F JSON girdisini onar ve biçimlendir
Alt + Shift + S Yönü değiştir
Alt + Shift + T Kod, ağaç ve harita görünümleri arasında geçiş yap
Ctrl / ⌘ + Z Geri al (Biçimlendir, Onar ve Temizle dahil)
Esc Tam ekrandan çık
Düzenleyici metin boyutu

JSON'dan YAML'a bir iş akışı

Tetikleyiciler, matrix değerleri, ifadeler ve çok satırlı betikler elle yazacağınız şekilde çıkar.

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

İş akışı dosyalarında nelere dikkat etmeli

Dönüştürücünün çıktısı ile aynı satırların tırnaksız hâli arasında geçiş yapın ve her YAML sürümünün bunları nasıl okuduğunu karşılaştırın.

on anahtarı

Yalın bir on, YAML 1.1'de true demektir. 'on' olarak tırnaklamak her ayrıştırıcıyı ve linter'ı memnun eder.

Sürüm dizeleri

'20' veya '3.10' gibi matrix değerleri tırnaklı kalır, böylece Python 3.10 asla 3.1'e dönüşmez.

Değişmez run blokları

Satır sonu içeren dizeler run: | bloklarına dönüşür ve her komut kendi satırında kalır.

Diğer araçlar

JSON ve YAML'ın buluştuğu her yer için dönüştürücüler, doğrulayıcılar ve adım adım kılavuzlar.

Sıkça sorulan sorular

JSON'u bir GitHub Actions iş akışına nasıl dönüştürürüm?

JSON'u düzenleyiciye yapıştırın, YAML'ı kopyalayın ve deponuzda .github/workflows/ altına kaydedin, örneğin .github/workflows/ci.yml. İş akışı bir sonraki eşleşen olayda çalışır.

on anahtarı neden 'on' olarak yazılıyor?

YAML 1.1'de yalın bir on, mantıksal true değeridir; bu yüzden bazı araçlar tetikleyici anahtarını on yerine true olarak okur. Tırnaklamak belirsizliği ortadan kaldırır. GitHub her iki biçimi de kabul eder, yani 'on': her yerde güvenlidir.

${{ }} ifadeleri korunuyor mu?

Evet. ${{ matrix.node }} ve ${{ secrets.TOKEN }} gibi ifadeler hem JSON'da hem YAML'da düz dizelerdir ve girdide göründükleri gibi aynen yazılır.

Çok satırlı run betikleri nasıl dönüştürülür?

\n satır sonları içeren bir JSON dizesi, satır başına bir komut içeren bir YAML değişmez bloğuna (run: |) dönüşür; iş akışı betikleri normalde böyle yazılır.

Bir iş akışını push etmeden önce nasıl kontrol ederim?

Bu dönüştürücü YAML sözdizimini kontrol eder. Bilinmeyen anahtarlar, geçersiz ifadeler veya yanlış runner etiketleri gibi iş akışına özgü kontroller için actionlint'i yerelde veya CI'da çalıştırın.