এটি JSON-কে ইনডেন্টেশন-ভিত্তিক YAML-এ বদলে দেয়। বন্ধনী আর বেশিরভাগ কোট চলে যায়, ফলে config ফাইল হিসেবে হাতে রক্ষণাবেক্ষণ করা সহজ হয়, আর key-এর ক্রম মূল JSON-এর মতোই হুবহু থাকে।
kubectl get -o json দিয়ে আনা কোনো resource manifest-এ সরাতে, অথবা API থেকে পাওয়া সেটিংস docker-compose.yml, application.yml বা GitHub Actions workflow-তে পেস্ট করতে এটি কাজে আসে।
JSON বক্সে JSON পেস্ট করুন। Syntax ভুল হলে ফলাফলে JSON parsing failed দেখায়; দরকার হলে আগে JSON validator দিয়ে যাচাই করুন।ফলাফল-এর নিচে YAML পর্যালোচনা করুন। ইনডেন্টেশন দুই স্পেস।{
"services": {
"web": {
"image": "nginx:1.27",
"ports": ["8080:80"],
"environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
}
}
}services:
web:
image: nginx:1.27
ports:
- 8080:80
environment:
FEATURE_FLAG: "on"
GREETING: |-
hello
world
স্ট্রিং "on" তার কোট রাখে: কোট ছাড়া on লিখলে YAML 1.1 parser এটিকে boolean true হিসেবে পড়ত। GREETING-এ newline আছে, তাই এটি একটি |- ব্লক হিসেবে লেখা হয়, যা প্রতিটি লাইন যেমন লেখা তেমনই দেখায়।
yes, no, on, off, y, n, ~, null-এর মতো স্ট্রিং, আর "0777", "1.0" বা "2024-01-01"-এর মতো দেখতে একই রকম স্ট্রিং কোটে রাখা হয়, যাতে PyYAML (1.1) আর আধুনিক 1.2 parser একই ভ্যালু পড়ে।22:22-এর মতো স্ট্রিং, যা YAML 1.1 base-60 সংখ্যা হিসেবে পড়তে পারে, সেগুলোও কোটে রাখা হয়, ফলে docker-compose-এর port-mapping-এর একটি পরিচিত বাগ এড়ানো যায়।|- literal ব্লক হয়।[] আর {} হিসেবেই থাকে।ক্লাস্টার থেকে JSON হিসেবে আনা একটি Deployment বা ConfigMap কনভার্ট করুন, status আর metadata.uid-এর মতো ফিল্ড মুছে দিন, তাহলেই Git-এর জন্য প্রস্তুত একটি manifest পাবেন।
Config সার্ভার বা ডকুমেন্টেশন থেকে JSON হিসেবে পাওয়া property-র ব্লক YAML hierarchy হয়ে যায়, তাই spring.datasource.url-এর মতো key হাতে ইনডেন্ট করতে হয় না।
&) বা alias (*) তৈরি হয় না; JSON-এ পুনরাবৃত্ত অবজেক্ট YAML-এও পুনরাবৃত্ত হয়।--- দিয়ে আলাদা করা একাধিক resource-এর ফাইলের জন্য প্রতিটি resource কনভার্ট করে নিজে জোড়া দিন।কোট যোগ হয় শুধু যেখানে কোট ছাড়া ভ্যালু অন্য type হিসেবে পড়া হতো। nginx:1.27 যেভাবেই হোক স্ট্রিং, কিন্তু on, 010 আর 22:22 কিছু parser-এ boolean বা সংখ্যায় পরিণত হয়, তাই সেগুলো কোট পায়।
গঠনটি যেমন আছে তেমনই বৈধ। তবে kubectl get -o json-এর আউটপুটে status, resourceVersion আর managedFields-এর মতো সার্ভারের পূরণ করা ফিল্ড থাকে, এবং apply করার আগে সেগুলো সরিয়ে ফেলাই ভালো।
কোনো অপশন নেই; এটি দুই স্পেসে নির্দিষ্ট, যা Kubernetes, docker-compose আর GitHub Actions ডকুমেন্টেশন জুড়ে ব্যবহৃত রীতি।