I-convert ang JSON sa YAML!

Maglagay ng JSON para gawing madaling basahing YAML! Sinusuportahan ang yml, Kubernetes, docker-compose, Spring application.yml.
JSON
Resulta
 

I-convert ang JSON sa YAML!

Ginagawa nitong indentation-based na YAML ang JSON. Nawawala ang mga brace at karamihan ng quote, kaya mas madaling i-maintain nang mano-mano ang resulta bilang config file, at eksaktong napapanatili ang pagkakasunod ng mga key gaya ng sa source JSON.

Nakakatulong ito kapag inililipat mo sa isang manifest ang resource na nakuha gamit ang kubectl get -o json, o nagpe-paste ng settings na natanggap mula sa isang API papunta sa docker-compose.yml, application.yml o isang GitHub Actions workflow.

Paano gamitin

  1. I-paste ang JSON sa JSON box. Kapag invalid ang syntax, lumalabas ang JSON parsing failed sa resulta; patakbuhin muna ito sa JSON validator kung kailangan.
  2. I-review ang YAML sa ilalim ng Resulta. Dalawang espasyo ang indentation.
  3. Kopyahin ito sa .yml file mo, at ayusin ang lalim ng indent kung ilalagay mo ito sa ilalim ng ibang block.

Halimbawa

Input (JSON)
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": ["8080:80"],
      "environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
    }
  }
}
Output (YAML)
services:
  web:
    image: nginx:1.27
    ports:
      - 8080:80
    environment:
      FEATURE_FLAG: "on"
      GREETING: |-
        hello
        world

Napapanatili ng string na "on" ang mga quote nito: kapag isinulat nang walang quote bilang on, babasahin ito ng isang YAML 1.1 parser bilang boolean na true. May newline ang GREETING, kaya inilalabas ito bilang |- block na ipinapakita ang bawat linya gaya ng pagkakasulat.

Mga sinusuportahang feature

  • Sinusunod ng quoting ang YAML 1.1. Kino-quote ang mga string gaya ng yes, no, on, off, y, n, ~, null, at mga kamukha gaya ng "0777", "1.0" o "2024-01-01", para parehong value ang mabasa ng PyYAML (1.1) at ng mga modernong 1.2 parser.
  • Kino-quote din ang mga string gaya ng 22:22, na kayang basahin ng YAML 1.1 bilang base-60 na numero, para maiwasan ang isang klasikong bug sa port mapping ng docker-compose.
  • Nagiging |- literal block ang mga string na maraming linya.
  • Hindi kailanman tinutupi ang mahahabang string (walang limit sa haba ng linya).
  • Nananatiling [] at {} ang mga empty array at object.

Mga gamit

Mula kubectl JSON output papuntang manifest

I-convert ang isang Deployment o ConfigMap na kinuha mula sa cluster bilang JSON, burahin ang mga field gaya ng status at metadata.uid, at may manifest ka nang handa para sa Git.

Pagsulat ng application.yml ng Spring Boot

Nagiging YAML hierarchy ang isang block ng property na natanggap bilang JSON mula sa isang config server o docs, kaya hindi mo na kailangang mano-manong i-indent ang mga key gaya ng spring.datasource.url.

Mga paalala at limitasyon

  • Walang ginagawang comment, anchor (&) o alias (*); inuulit sa YAML ang object na paulit-ulit sa JSON.
  • Nawawalan ng precision ang mga integer na lampas sa 9007199254740991 dahil sa number limit ng JavaScript; panatilihing string sa JSON ang mahahabang ID.
  • Iisang document ang output. Para sa file na maraming resource na pinaghihiwalay ng ---, i-convert ang bawat resource at ikaw na ang magdugtong sa kanila.

Mga madalas itanong

Bakit naka-quote ang ilang string at ang iba ay hindi?

Idinadagdag lang ang quote kung saan babasahin bilang ibang type ang value na walang quote. String ang nginx:1.27 alinman ang mangyari, pero nagiging boolean o numero ang on, 010 at 22:22 sa ilang parser, kaya kino-quote sila.

Puwede ko bang i-apply nang direkta sa Kubernetes ang output?

Valid na ang istruktura nang ganoon lang. Pero may dalang mga field na pinupunan ng server ang output ng kubectl get -o json, gaya ng status, resourceVersion at managedFields, at mas mabuting tanggalin sila bago mag-apply.

Puwede ba akong lumipat sa indentation na apat na espasyo?

Walang option; nakapirmi ito sa dalawang espasyo, ang convention na ginagamit sa buong dokumentasyon ng Kubernetes, docker-compose at GitHub Actions.