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.
JSON box. Kapag invalid ang syntax, lumalabas ang JSON parsing failed sa resulta; patakbuhin muna ito sa JSON validator kung kailangan.Resulta. Dalawang espasyo ang indentation.{
"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
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.
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.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.|- literal block ang mga string na maraming linya.[] at {} ang mga empty array at object.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.
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.
&) o alias (*); inuulit sa YAML ang object na paulit-ulit sa JSON.---, i-convert ang bawat resource at ikaw na ang magdugtong sa kanila.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.
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.
Walang option; nakapirmi ito sa dalawang espasyo, ang convention na ginagamit sa buong dokumentasyon ng Kubernetes, docker-compose at GitHub Actions.