YAML (yml) document को JSON में बदलें, ताकि indentation के पीछे छिपी संरचना और हर वैल्यू किस type के रूप में parse हुई, यह दिख सके। Anchors और aliases असली values में फैलाए जाते हैं, और --- से अलग किए कई documents एक array में इकट्ठा होते हैं।
यह YAML की पुरानी गलतियां पकड़ने में खास तौर पर काम आता है: एक space कम होने से किसी वैल्यू का गलत parent से जुड़ जाना, या version: 1.10 का चुपचाप संख्या 1.1 बन जाना।
YAML बॉक्स में पेस्ट करें, या फ़ाइल उस पर drop करें।परिणाम के नीचे का JSON पढ़कर देखें कि हर वैल्यू string, संख्या या boolean बनी, और ज़रूरत हो तो उसे कॉपी करें।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
}
}
}GitHub Actions की on: key string key "on" ही रहती है, क्योंकि यह टूल YAML 1.2 नियमों से parse करता है। &node anchor से define किया block *node की जगह फैलाया जाता है।
yes, on और off strings रहते हैं, और सिर्फ़ true/True/false booleans बनते हैं।~ और खाली values null बनती हैं; hex 0x1F और octal 0o17 संख्याएं बनते हैं।&anchors और *aliases reference की गई values में resolve होते हैं।| और folded > block scalars YAML के newline नियम लागू करके strings में बदले जाते हैं।--- से अलग कई documents JSON array बनते हैं; एक अकेला document अपनी ही वैल्यू के रूप में निकलता है।अगर containers के नीचे env एक स्तर कम indent है, तो वह चुपचाप किसी दूसरे field से जुड़ जाता है और आपको apply के समय ही पता चलता है। JSON में braces ठीक दिखाते हैं कि वह किस object का है।
किसी script या front-end bundle के लिए जहां YAML parser जोड़ना ज़्यादा है, config को एक बार बदलें और उसे import config from './config.json' के रूप में इस्तेमाल करें।
YAML में लिखा OpenAPI document बदलने के बाद JSONPath या jq से query करना आसान होता है, उदाहरण के लिए किसी खास path का schema निकालना।
<<: *defaults) लागू होती हैं: anchor वाली mapping की keys कॉपी होती हैं, और << के पास लिखी keys उन्हें override करती हैं। सिर्फ़ YAML 1.2 वाला parser << को सादी key रखेगा, इसलिए ऐसे टूल्स से परिणाम अलग हो सकते हैं।2024-01-01 जैसी तारीखें और समय Date values बनने की बजाय strings रहते हैं।.inf और .nan का JSON में कोई रूप नहीं है और वे null बनते हैं।on और yes को true पढ़ता है, इसलिए Python के परिणाम अलग हो सकते हैं।on true की बजाय "on" क्यों दिखता है?YAML 1.2 में सिर्फ़ true और false booleans हैं, इसलिए on एक सामान्य string है, और GitHub Actions भी key को इसी तरह पढ़ता है। Python का PyYAML 1.1 का पालन करता है और इसे True key बना देता है, इसलिए scripts से workflows parse करते समय सावधान रहें।
version: 1.10 1.1 के रूप में आता है।बिना quotes का 1.10 YAML में संख्या है, और 1.10 1.1 के बराबर है। Version string रखने के लिए source YAML में उसे "1.10" के रूप में quote करें।
--- से अलग हर document क्रम से array का element बनता है, इसलिए kubectl apply -f के साथ इस्तेमाल होने वाली कई resources वाली फ़ाइल से resources का array मिलता है।