JSON को YAML में बदलें!

JSON डालें और उसे पढ़ने में आसान YAML में बदलें! yml, Kubernetes, docker-compose, Spring application.yml समर्थित।
JSON
परिणाम
 

JSON को YAML में बदलें!

यह JSON को indentation-आधारित YAML में बदलता है। Braces और ज़्यादातर quotes गायब हो जाते हैं, जिससे परिणाम को config फ़ाइल के रूप में हाथ से संभालना आसान होता है, और keys का क्रम ठीक source JSON जैसा रहता है।

यह तब मदद करता है जब kubectl get -o json से लाए resource को manifest में ले जाना हो, या API से मिली settings को docker-compose.yml, application.yml या GitHub Actions workflow में पेस्ट करना हो।

उपयोग कैसे करें

  1. JSON बॉक्स में JSON पेस्ट करें। गलत syntax पर परिणाम में JSON parsing failed दिखता है; ज़रूरत हो तो पहले JSON validator से जांच लें।
  2. परिणाम के नीचे YAML की समीक्षा करें। Indentation दो spaces का है।
  3. इसे अपनी .yml फ़ाइल में कॉपी करें, और अगर किसी दूसरे block के अंदर रख रहे हैं तो indent की गहराई ठीक करें।

उदाहरण

इनपुट (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

String "on" अपने quotes रखती है: बिना quotes के on लिखने पर YAML 1.1 parser उसे boolean true पढ़ेगा। GREETING में newline है, इसलिए वह |- block के रूप में निकलता है जो हर line को लिखे अनुसार दिखाता है।

समर्थित सुविधाएँ

  • Quoting YAML 1.1 का पालन करती है। yes, no, on, off, y, n, ~, null जैसी strings, और "0777", "1.0" या "2024-01-01" जैसी हमशक्ल strings quote होती हैं, ताकि PyYAML (1.1) और आधुनिक 1.2 parsers एक ही वैल्यू पढ़ें।
  • 22:22 जैसी strings, जिन्हें YAML 1.1 base-60 संख्या पढ़ सकता है, भी quote होती हैं, जिससे docker-compose port-mapping का एक पुराना bug टलता है।
  • कई lines वाली strings |- literal blocks बनती हैं।
  • लंबी strings कभी fold नहीं होतीं (line width की कोई सीमा नहीं)।
  • खाली arrays और objects [] और {} ही रहते हैं।

उपयोग के मामले

kubectl JSON आउटपुट से manifest तक

Cluster से JSON के रूप में खींचे Deployment या ConfigMap को बदलें, status और metadata.uid जैसे fields हटाएं, और Git के लिए तैयार manifest आपके पास है।

Spring Boot application.yml लिखना

Config server या docs से JSON के रूप में मिला properties का block YAML hierarchy बन जाता है, इसलिए spring.datasource.url जैसी keys को हाथ से indent नहीं करना पड़ता।

नोट्स और सीमाएँ

  • Comments, anchors (&) या aliases (*) नहीं बनते; JSON में दोहराया गया object YAML में भी दोहराया जाता है।
  • JavaScript की number सीमा के कारण 9007199254740991 से बड़े integers precision खो देते हैं; लंबी IDs को JSON में strings के रूप में रखें।
  • आउटपुट एक ही document है। --- से अलग किए कई resources वाली फ़ाइल के लिए हर resource बदलें और उन्हें खुद जोड़ें।

अक्सर पूछे जाने वाले प्रश्न

कुछ strings quote क्यों होती हैं और कुछ नहीं?

Quotes सिर्फ़ वहीं जुड़ते हैं जहां बिना quotes वाली वैल्यू किसी दूसरे type के रूप में पढ़ी जाती। nginx:1.27 हर हाल में string है, लेकिन on, 010 और 22:22 कुछ parsers में booleans या संख्याएं बन जाते हैं, इसलिए उन्हें quote किया जाता है।

क्या आउटपुट सीधे Kubernetes पर apply कर सकते हैं?

संरचना जैसी है वैसी वैध है। हालांकि kubectl get -o json के आउटपुट में status, resourceVersion और managedFields जैसे server के भरे fields होते हैं, और apply करने से पहले उन्हें हटाना बेहतर है।

क्या चार spaces वाले indentation पर जा सकते हैं?

कोई option नहीं है; यह दो spaces पर तय है, जो Kubernetes, docker-compose और GitHub Actions documentation में हर जगह इस्तेमाल होने वाला convention है।