یہ JSON کو indentation پر مبنی YAML میں بدلتا ہے۔ braces اور زیادہ تر quotes غائب ہو جاتے ہیں، جس سے نتیجہ config فائل کے طور پر ہاتھ سے سنبھالنا آسان ہو جاتا ہے، اور keys کی ترتیب بالکل ماخذ JSON جیسی رہتی ہے۔
یہ تب کام آتا ہے جب آپ kubectl get -o json سے حاصل کیے گئے resource کو manifest میں منتقل کریں، یا API سے ملی settings کو docker-compose.yml، application.yml یا GitHub Actions workflow میں پیسٹ کریں۔
JSON باکس میں JSON پیسٹ کریں۔ غلط syntax پر نتیجے میں JSON parsing failed دکھائی دیتا ہے؛ ضرورت ہو تو پہلے JSON validator سے گزار لیں۔نتیجہ کے نیچے YAML کا جائزہ لیں۔ indentation دو spaces کی ہے۔{
"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
string "on" اپنے quotes برقرار رکھتی ہے: اگر اسے بغیر quotes کے on لکھا جائے تو YAML 1.1 parser اسے boolean true پڑھے گا۔ GREETING میں newline ہے، اس لیے اسے |- بلاک کی صورت میں لکھا جاتا ہے جو ہر لائن ویسی ہی دکھاتا ہے جیسی لکھی گئی تھی۔
yes، no، on، off، y، n، ~، null جیسی strings، اور "0777"، "1.0" یا "2024-01-01" جیسی ملتی جلتی values پر quotes لگائے جاتے ہیں تاکہ PyYAML (1.1) اور جدید 1.2 parsers ایک ہی value پڑھیں۔22:22 جیسی strings، جنہیں YAML 1.1 base-60 نمبر پڑھ سکتا ہے، پر بھی quotes لگتے ہیں، جس سے docker-compose کا مشہور port-mapping bug نہیں ہوتا۔|- literal blocks بن جاتی ہیں۔[] اور {} ہی رہتے ہیں۔cluster سے JSON کی صورت میں نکالے گئے Deployment یا ConfigMap کو تبدیل کریں، status اور metadata.uid جیسے فیلڈز مٹائیں، اور آپ کے پاس Git کے لیے تیار manifest ہوگا۔
config server یا docs سے JSON کی صورت میں ملا properties کا بلاک YAML hierarchy بن جاتا ہے، اس لیے spring.datasource.url جیسی keys کو ہاتھ سے indent نہیں کرنا پڑتا۔
&) یا aliases (*) نہیں بنائے جاتے؛ JSON میں دہرایا گیا آبجیکٹ YAML میں بھی دہرایا جاتا ہے۔--- سے الگ کیے گئے کئی resources والی فائل کے لیے ہر resource الگ سے تبدیل کر کے خود جوڑیں۔quotes صرف وہاں لگتے ہیں جہاں بغیر quotes کی value کسی اور type کے طور پر پڑھی جائے۔ nginx:1.27 ہر صورت string ہے، لیکن on، 010 اور 22:22 کچھ parsers میں booleans یا نمبر بن جاتے ہیں، اس لیے ان پر quotes لگتے ہیں۔
ڈھانچہ جوں کا توں درست ہے۔ البتہ kubectl get -o json کے آؤٹ پٹ میں سرور کے بھرے ہوئے status، resourceVersion اور managedFields جیسے فیلڈز ہوتے ہیں، جنہیں apply کرنے سے پہلے ہٹا دینا بہتر ہے۔
اس کا کوئی option نہیں؛ یہ دو spaces پر مقرر ہے، جو Kubernetes، docker-compose اور GitHub Actions کی پوری documentation میں رائج ہے۔