JSON ke YAML GitHub Actions

Ubah definisi workflow JSON menjadi file .github/workflows yang rapi, siap di-commit.

Opsi output

JSONinput

Kosong

YAMLoutput

Output YAML muncul di sini

Berjalan sepenuhnya di browser Anda: tidak ada yang diunggah. Batas penggunaan wajar berlaku (5 MB per input, jumlah konversi dibatasi) untuk mencegah spam dan bot.

Muat dari URL

File diambil langsung oleh browser Anda, sehingga server harus mengizinkan permintaan lintas asal (cross-origin).

Pintasan keyboard

Ctrl / ⌘ + Enter Konversi sekarang
Ctrl / ⌘ + S Unduh output
Alt + Shift + C Salin output
Alt + Shift + F Perbaiki dan format input JSON
Alt + Shift + S Tukar arah
Alt + Shift + T Beralih antara tampilan kode, pohon, dan peta
Ctrl / ⌘ + Z Urungkan, termasuk Format, Perbaiki, dan Hapus
Esc Keluar dari layar penuh
Ukuran teks editor

Sebuah workflow, dari JSON ke YAML

Trigger, nilai matrix, ekspresi, dan skrip multibaris semuanya keluar seperti yang akan Anda tulis secara manual.

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

Yang perlu diperhatikan di file workflow

Beralih antara output konverter dan baris yang sama yang ditulis tanpa tanda kutip, lalu bandingkan cara setiap versi YAML membacanya.

Kunci on

on tanpa tanda kutip adalah true di YAML 1.1. Mengutipnya sebagai 'on' membuat setiap parser dan linter tetap senang.

String versi

Nilai matrix seperti '20' atau '3.10' tetap dikutip, sehingga Python 3.10 tidak pernah berubah menjadi 3.1.

Blok run literal

String dengan jeda baris menjadi blok run: |, sehingga setiap perintah tetap di barisnya sendiri.

Alat lainnya

Konverter, validator, dan panduan langkah demi langkah untuk setiap tempat JSON dan YAML bertemu.

Pertanyaan yang sering diajukan

Bagaimana cara mengonversi JSON menjadi workflow GitHub Actions?

Tempel JSON ke editor, salin YAML-nya, dan simpan di repositori Anda di bawah .github/workflows/, misalnya .github/workflows/ci.yml. Workflow akan berjalan pada event berikutnya yang cocok.

Mengapa kunci on ditulis sebagai 'on'?

Di YAML 1.1, on tanpa tanda kutip adalah boolean true, sehingga beberapa alat membaca kunci trigger sebagai true, bukan on. Memberi tanda kutip menghilangkan ambiguitas itu. GitHub menerima kedua bentuk, jadi 'on': aman di mana saja.

Apakah ekspresi ${{ }} dipertahankan?

Ya. Ekspresi seperti ${{ matrix.node }} dan ${{ secrets.TOKEN }} adalah string biasa di JSON maupun YAML dan ditulis persis seperti di input.

Bagaimana skrip run multibaris dikonversi?

String JSON yang berisi jeda baris \n menjadi blok literal YAML (run: |), dengan satu perintah per baris, yang merupakan cara skrip workflow biasanya ditulis.

Bagaimana cara memeriksa workflow sebelum di-push?

Konverter ini memeriksa sintaks YAML. Untuk pemeriksaan khusus workflow seperti kunci yang tidak dikenal, ekspresi yang tidak valid, atau label runner yang salah, jalankan actionlint secara lokal atau di CI.