একটি YAML (yml) ডকুমেন্টকে JSON-এ কনভার্ট করে দেখুন ইনডেন্টেশন যে গঠন লুকিয়ে রাখে, আর প্রতিটি ভ্যালু আসলে কোন type হিসেবে parse হয়েছে। Anchor আর alias আসল ভ্যালুতে প্রসারিত হয়, আর --- দিয়ে আলাদা করা একাধিক ডকুমেন্ট একটি array-তে জড়ো হয়।
YAML-এর পরিচিত ভুল ধরতে এটি বিশেষভাবে কাজে আসে: একটি স্পেস কম থাকায় ভুল parent-এর সাথে যুক্ত হয়ে যাওয়া ভ্যালু, অথবা version: 1.10 নিঃশব্দে সংখ্যা 1.1 হয়ে যাওয়া।
YAML বক্সে একটি docker-compose.yml, Kubernetes manifest বা workflow ফাইল পেস্ট করুন, অথবা ফাইলটি ড্র্যাগ করে ছাড়ুন।ফলাফল-এর নিচের JSON পড়ুন, আর দরকার হলে কপি করুন।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 স্ট্রিং key "on" হিসেবেই থাকে, কারণ এই টুল YAML 1.2-এর নিয়মে parse করে। &node anchor দিয়ে ডিফাইন করা ব্লকটি *node-এর জায়গায় প্রসারিত হয়।
yes, on আর off স্ট্রিং থাকে, আর শুধু true/True/false boolean হয়।~ আর ফাঁকা ভ্যালু হয় null; hex 0x1F আর octal 0o17 সংখ্যা হয়।&anchors আর *aliases নির্দেশিত ভ্যালুতে resolve হয়।| আর folded > block scalar YAML-এর newline নিয়ম প্রয়োগ করে স্ট্রিংয়ে বদলানো হয়।--- দিয়ে আলাদা কয়েকটি ডকুমেন্ট একটি JSON array হয়; একটিমাত্র ডকুমেন্ট তার নিজের ভ্যালু হিসেবে আউটপুট হয়।containers-এর নিচের env এক ধাপ কম ইনডেন্ট করা থাকলে সেটি নিঃশব্দে অন্য ফিল্ডের সাথে যুক্ত হয়ে যায়, আর তা ধরা পড়ে শুধু apply করার সময়। JSON-এ বন্ধনীগুলো দেখায় এটি ঠিক কোন অবজেক্টের অংশ।
যেসব স্ক্রিপ্ট বা ফ্রন্টএন্ড bundle-এ YAML parser যোগ করা বাড়াবাড়ি, সেখানে config একবার কনভার্ট করে import config from './config.json' হিসেবে ব্যবহার করুন।
YAML-এ লেখা OpenAPI ডকুমেন্ট কনভার্ট করার পর JSONPath বা jq দিয়ে কোয়েরি করা সহজ হয়, যেমন নির্দিষ্ট path-এর schema বের করা।
<<: *defaults) প্রয়োগ হয়: anchor করা mapping-এর key-গুলো কপি হয়ে আসে, আর <<-এর পাশে লেখা key সেগুলোকে override করে। শুধু YAML 1.2 মানা parser <<-কে সাধারণ key হিসেবে রাখত, তাই এমন টুলের সাথে ফলাফল আলাদা হতে পারে।2024-01-01-এর মতো তারিখ ও সময় Date ভ্যালু না হয়ে স্ট্রিং থাকে।.inf আর .nan-এর কোনো JSON রূপ নেই, তাই সেগুলো null হয়।on আর yes-কে true হিসেবে পড়ে, তাই Python-এর ফলাফল আলাদা হতে পারে।on কেন true না হয়ে "on" দেখায়?YAML 1.2-এ boolean শুধু true আর false, তাই on একটি সাধারণ স্ট্রিং, আর GitHub Actions-ও key-টি এভাবেই পড়ে। Python-এর PyYAML 1.1 মানে এবং এটিকে True key-তে বদলে দেয়, তাই স্ক্রিপ্ট থেকে workflow parse করার সময় সাবধান থাকুন।
version: 1.10 আসছে 1.1 হিসেবে।কোট ছাড়া 1.10 YAML-এ একটি সংখ্যা, আর 1.10 মানে 1.1। ভার্সন স্ট্রিং রাখতে মূল YAML-এ "1.10" হিসেবে কোটে লিখুন।
--- দিয়ে আলাদা প্রতিটি ডকুমেন্ট ক্রমানুসারে একটি array element হয়, তাই kubectl apply -f-এ ব্যবহৃত একাধিক resource-এর ফাইল থেকে resource-গুলোর একটি array পাওয়া যায়।