Tukar dokumen YAML (yml) kepada JSON untuk melihat struktur yang tersembunyi di sebalik indentasi serta jenis sebenar setiap nilai selepas dihuraikan. Anchor dan alias dikembangkan menjadi nilai sebenar, dan beberapa dokumen yang dipisahkan dengan --- dikumpulkan ke dalam array.
Ia amat berguna untuk mengesan kesilapan YAML klasik: nilai yang melekat pada induk yang salah kerana kekurangan satu ruang, atau version: 1.10 yang secara senyap menjadi nombor 1.1.
YAML, atau letakkan fail ke atasnya.Hasil untuk melihat sama ada setiap nilai menjadi rentetan, nombor atau boolean, dan salinnya jika perlu.name: ci
on:
push:
branches: [main]
defaults: &node
runs-on: ubuntu-latest
timeout-minutes: 10
jobs:
test: *node
{
"name": "ci",
"on": {
"push": {
"branches": [
"main"
]
}
},
"defaults": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
},
"jobs": {
"test": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
}
}
}Kunci on: GitHub Actions kekal sebagai kunci rentetan "on", kerana alat ini menghurai mengikut peraturan YAML 1.2. Blok yang ditakrifkan dengan anchor &node dikembangkan di tempat *node.
yes, on dan off kekal sebagai rentetan, dan hanya true/True/false menjadi boolean.~ dan nilai kosong menjadi null; hex 0x1F dan oktal 0o17 menjadi nombor.&anchors dan *aliases dileraikan kepada nilai yang dirujuk.| dan folded > ditukar menjadi rentetan dengan peraturan baris baharu YAML diterapkan.--- menjadi array JSON; satu dokumen dikeluarkan sebagai nilainya sendiri.Jika env di bawah containers diindentasi satu tahap terlalu cetek, ia secara senyap melekat pada medan lain dan anda hanya mengetahuinya semasa apply. Dalam JSON, kurungan menunjukkan dengan tepat objek mana yang memilikinya.
Untuk skrip atau bundle front-end yang tidak berbaloi ditambah parser YAML, tukar konfigurasi sekali dan gunakannya sebagai import config from './config.json'.
Dokumen OpenAPI yang ditulis dalam YAML lebih mudah di-query dengan JSONPath atau jq selepas ditukar, contohnya untuk mengeluarkan skema pada laluan tertentu.
<<: *defaults) diterapkan: kunci mapping yang di-anchor disalin masuk, dan kunci yang ditulis di sebelah << mengatasinya. Parser yang hanya menyokong YAML 1.2 akan mengekalkan << sebagai kunci biasa, jadi hasilnya mungkin berbeza daripada alat sedemikian.2024-01-01 kekal sebagai rentetan dan tidak menjadi nilai Date..inf dan .nan tiada perwakilan dalam JSON dan menjadi null.on dan yes sebagai true, jadi hasil daripada Python mungkin berbeza.on GitHub Actions dipaparkan sebagai "on" dan bukan true?Dalam YAML 1.2, satu-satunya boolean ialah true dan false, jadi on ialah rentetan biasa, dan begitulah juga GitHub Actions membaca kunci itu. PyYAML Python mengikut 1.1 dan menukarnya kepada kunci True, jadi berhati-hati apabila menghurai workflow daripada skrip.
version: 1.10 keluar sebagai 1.1.1.10 tanpa petikan ialah nombor dalam YAML, dan 1.10 sama dengan 1.1. Untuk mengekalkan rentetan versi, letakkan petikan dalam YAML sumber sebagai "1.10".
Setiap dokumen yang dipisahkan dengan --- menjadi elemen array mengikut susunan, jadi fail berbilang resource yang digunakan dengan kubectl apply -f menghasilkan array resource.