JSON কে YAML-এ রূপান্তর করুন!

JSON দিন এবং সহজে পড়া যায় এমন YAML পান! yml, Kubernetes, docker-compose, Spring application.yml সমর্থিত।
JSON
ফলাফল
 

JSON কে YAML-এ রূপান্তর করুন!

এটি JSON-কে ইনডেন্টেশন-ভিত্তিক YAML-এ বদলে দেয়। বন্ধনী আর বেশিরভাগ কোট চলে যায়, ফলে config ফাইল হিসেবে হাতে রক্ষণাবেক্ষণ করা সহজ হয়, আর key-এর ক্রম মূল JSON-এর মতোই হুবহু থাকে।

kubectl get -o json দিয়ে আনা কোনো resource manifest-এ সরাতে, অথবা API থেকে পাওয়া সেটিংস docker-compose.yml, application.yml বা GitHub Actions workflow-তে পেস্ট করতে এটি কাজে আসে।

কীভাবে ব্যবহার করবেন

  1. JSON বক্সে JSON পেস্ট করুন। Syntax ভুল হলে ফলাফলে JSON parsing failed দেখায়; দরকার হলে আগে JSON validator দিয়ে যাচাই করুন।
  2. ফলাফল-এর নিচে YAML পর্যালোচনা করুন। ইনডেন্টেশন দুই স্পেস।
  3. এটি আপনার .yml ফাইলে কপি করুন, অন্য কোনো ব্লকের নিচে বসালে ইনডেন্টের গভীরতা ঠিক করে নিন।

উদাহরণ

ইনপুট (JSON)
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": ["8080:80"],
      "environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
    }
  }
}
আউটপুট (YAML)
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 আছে, তাই এটি একটি |- ব্লক হিসেবে লেখা হয়, যা প্রতিটি লাইন যেমন লেখা তেমনই দেখায়।

সমর্থিত বৈশিষ্ট্য

  • কোট দেওয়ার নিয়ম YAML 1.1 মানে। 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 ব্লক হয়।
  • লম্বা স্ট্রিং কখনো ভাঁজ করা হয় না (লাইনের দৈর্ঘ্যের কোনো সীমা নেই)।
  • ফাঁকা array আর অবজেক্ট [] আর {} হিসেবেই থাকে।

ব্যবহারের ক্ষেত্র

kubectl-এর JSON আউটপুট থেকে manifest

ক্লাস্টার থেকে JSON হিসেবে আনা একটি Deployment বা ConfigMap কনভার্ট করুন, status আর metadata.uid-এর মতো ফিল্ড মুছে দিন, তাহলেই Git-এর জন্য প্রস্তুত একটি manifest পাবেন।

Spring Boot-এর application.yml লেখা

Config সার্ভার বা ডকুমেন্টেশন থেকে JSON হিসেবে পাওয়া property-র ব্লক YAML hierarchy হয়ে যায়, তাই spring.datasource.url-এর মতো key হাতে ইনডেন্ট করতে হয় না।

নোট ও সীমাবদ্ধতা

  • কোনো কমেন্ট, anchor (&) বা alias (*) তৈরি হয় না; JSON-এ পুনরাবৃত্ত অবজেক্ট YAML-এও পুনরাবৃত্ত হয়।
  • JavaScript-এর সংখ্যার সীমার কারণে 9007199254740991-এর বেশি integer precision হারায়; লম্বা ID JSON-এ স্ট্রিং হিসেবে রাখুন।
  • আউটপুট একটিমাত্র ডকুমেন্ট। --- দিয়ে আলাদা করা একাধিক resource-এর ফাইলের জন্য প্রতিটি resource কনভার্ট করে নিজে জোড়া দিন।

সাধারণ প্রশ্ন

কিছু স্ট্রিং কোটে আর কিছু কোট ছাড়া কেন?

কোট যোগ হয় শুধু যেখানে কোট ছাড়া ভ্যালু অন্য type হিসেবে পড়া হতো। nginx:1.27 যেভাবেই হোক স্ট্রিং, কিন্তু on, 010 আর 22:22 কিছু parser-এ boolean বা সংখ্যায় পরিণত হয়, তাই সেগুলো কোট পায়।

আউটপুট কি সরাসরি Kubernetes-এ apply করা যায়?

গঠনটি যেমন আছে তেমনই বৈধ। তবে kubectl get -o json-এর আউটপুটে status, resourceVersion আর managedFields-এর মতো সার্ভারের পূরণ করা ফিল্ড থাকে, এবং apply করার আগে সেগুলো সরিয়ে ফেলাই ভালো।

চার স্পেসের ইনডেন্টেশনে কি বদলানো যায়?

কোনো অপশন নেই; এটি দুই স্পেসে নির্দিষ্ট, যা Kubernetes, docker-compose আর GitHub Actions ডকুমেন্টেশন জুড়ে ব্যবহৃত রীতি।