เครื่องมือนี้แปลง JSON เป็น YAML ที่ใช้การย่อหน้า วงเล็บปีกกาและเครื่องหมายคำพูดส่วนใหญ่หายไป ทำให้ดูแลผลลัพธ์ด้วยมือในฐานะไฟล์คอนฟิกได้ง่ายขึ้น และลำดับคีย์ยังตรงกับ JSON ต้นฉบับทุกประการ
ช่วยได้เมื่อย้าย resource ที่ดึงมาด้วย kubectl get -o json ไปเป็น manifest หรือนำค่าที่ได้รับจาก API ไปวางใน docker-compose.yml, application.yml หรือ workflow ของ GitHub Actions
JSON ถ้าไวยากรณ์ไม่ถูกต้อง ผลลัพธ์จะแสดง JSON parsing failed ถ้าจำเป็นให้ตรวจด้วย JSON validator ก่อนผลลัพธ์ การย่อหน้าเป็นช่องว่างสองช่อง{
"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
สตริง "on" ยังมีเครื่องหมายคำพูดอยู่ เพราะถ้าเขียน on เปล่า ๆ parser ของ YAML 1.1 จะอ่านเป็นบูลีน true GREETING มีการขึ้นบรรทัดใหม่ จึงถูกเขียนเป็นบล็อก |- ที่แสดงแต่ละบรรทัดตามที่เขียนไว้
yes, no, on, off, y, n, ~, null และค่าที่ดูคล้ายกันอย่าง "0777", "1.0" หรือ "2024-01-01" จะถูกใส่เครื่องหมายคำพูด เพื่อให้ PyYAML (1.1) และ parser 1.2 สมัยใหม่อ่านได้ค่าเดียวกัน22:22 ที่ YAML 1.1 อาจอ่านเป็นเลขฐาน 60 ก็ถูกใส่เครื่องหมายคำพูดเช่นกัน เลี่ยงบั๊กคลาสสิกเรื่องการแมปพอร์ตใน docker-compose|-[] และ {}แปลง Deployment หรือ ConfigMap ที่ดึงจากคลัสเตอร์เป็น JSON ลบฟิลด์อย่าง status และ metadata.uid แล้วคุณจะได้ manifest ที่พร้อมเก็บใน Git
ชุดพร็อพเพอร์ตีที่ได้มาเป็น JSON จาก config server หรือเอกสารจะกลายเป็นลำดับชั้นของ YAML จึงไม่ต้องย่อหน้าคีย์อย่าง spring.datasource.url เอง
&) หรือ alias (*) ออบเจ็กต์ที่ซ้ำใน JSON ก็จะซ้ำใน YAML--- ให้แปลงทีละ resource แล้วต่อกันเองเครื่องหมายคำพูดถูกเพิ่มเฉพาะเมื่อค่าเปล่า ๆ จะถูกอ่านเป็นไทป์อื่น nginx:1.27 เป็นสตริงอยู่แล้วไม่ว่าแบบไหน แต่ on, 010 และ 22:22 จะกลายเป็นบูลีนหรือตัวเลขใน parser บางตัว จึงต้องใส่เครื่องหมายคำพูด
โครงสร้างถูกต้องตามที่เป็นอยู่ แต่ผลลัพธ์จาก kubectl get -o json มีฟิลด์ที่เซิร์ฟเวอร์เติมให้อย่าง status, resourceVersion และ managedFields ซึ่งควรลบออกก่อน apply
ไม่มีตัวเลือกนี้ ถูกกำหนดไว้ที่สองช่อง ซึ่งเป็นธรรมเนียมที่ใช้ทั่วไปในเอกสารของ Kubernetes, docker-compose และ GitHub Actions