แปลง JSON เป็น YAML!

ป้อน JSON เพื่อแปลงเป็น YAML ที่อ่านง่าย! รองรับ yml, Kubernetes, docker-compose, Spring application.yml
JSON
ผลลัพธ์
 

แปลง JSON เป็น YAML!

เครื่องมือนี้แปลง JSON เป็น YAML ที่ใช้การย่อหน้า วงเล็บปีกกาและเครื่องหมายคำพูดส่วนใหญ่หายไป ทำให้ดูแลผลลัพธ์ด้วยมือในฐานะไฟล์คอนฟิกได้ง่ายขึ้น และลำดับคีย์ยังตรงกับ JSON ต้นฉบับทุกประการ

ช่วยได้เมื่อย้าย resource ที่ดึงมาด้วย kubectl get -o json ไปเป็น manifest หรือนำค่าที่ได้รับจาก API ไปวางใน docker-compose.yml, application.yml หรือ workflow ของ GitHub Actions

วิธีใช้

  1. วาง JSON ลงในช่อง JSON ถ้าไวยากรณ์ไม่ถูกต้อง ผลลัพธ์จะแสดง 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 เปล่า ๆ parser ของ YAML 1.1 จะอ่านเป็นบูลีน true GREETING มีการขึ้นบรรทัดใหม่ จึงถูกเขียนเป็นบล็อก |- ที่แสดงแต่ละบรรทัดตามที่เขียนไว้

ฟีเจอร์ที่รองรับ

  • การใส่เครื่องหมายคำพูดเป็นไปตาม YAML 1.1 สตริงอย่าง 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
  • สตริงหลายบรรทัดกลายเป็นบล็อก literal แบบ |-
  • สตริงยาวไม่ถูกพับบรรทัด (ไม่จำกัดความกว้างบรรทัด)
  • อาร์เรย์และออบเจ็กต์ว่างยังเป็น [] และ {}

กรณีการใช้งาน

จากผลลัพธ์ JSON ของ kubectl ไปเป็น manifest

แปลง Deployment หรือ ConfigMap ที่ดึงจากคลัสเตอร์เป็น JSON ลบฟิลด์อย่าง status และ metadata.uid แล้วคุณจะได้ manifest ที่พร้อมเก็บใน Git

เขียน application.yml ของ Spring Boot

ชุดพร็อพเพอร์ตีที่ได้มาเป็น JSON จาก config server หรือเอกสารจะกลายเป็นลำดับชั้นของ YAML จึงไม่ต้องย่อหน้าคีย์อย่าง spring.datasource.url เอง

ข้อควรระวังและข้อจำกัด

  • ไม่สร้างคอมเมนต์ anchor (&) หรือ alias (*) ออบเจ็กต์ที่ซ้ำใน JSON ก็จะซ้ำใน YAML
  • จำนวนเต็มที่เกิน 9007199254740991 จะสูญเสียความแม่นยำเพราะขีดจำกัดตัวเลขของ JavaScript ให้เก็บ ID ยาว ๆ เป็นสตริงใน JSON
  • ผลลัพธ์เป็นเอกสารเดียว ถ้าต้องการไฟล์หลาย resource ที่คั่นด้วย --- ให้แปลงทีละ resource แล้วต่อกันเอง

คำถามที่พบบ่อย

ทำไมบางสตริงมีเครื่องหมายคำพูดแต่บางสตริงไม่มี?

เครื่องหมายคำพูดถูกเพิ่มเฉพาะเมื่อค่าเปล่า ๆ จะถูกอ่านเป็นไทป์อื่น nginx:1.27 เป็นสตริงอยู่แล้วไม่ว่าแบบไหน แต่ on, 010 และ 22:22 จะกลายเป็นบูลีนหรือตัวเลขใน parser บางตัว จึงต้องใส่เครื่องหมายคำพูด

นำผลลัพธ์ไป apply กับ Kubernetes ได้เลยไหม?

โครงสร้างถูกต้องตามที่เป็นอยู่ แต่ผลลัพธ์จาก kubectl get -o json มีฟิลด์ที่เซิร์ฟเวอร์เติมให้อย่าง status, resourceVersion และ managedFields ซึ่งควรลบออกก่อน apply

เปลี่ยนเป็นย่อหน้าสี่ช่องได้ไหม?

ไม่มีตัวเลือกนี้ ถูกกำหนดไว้ที่สองช่อง ซึ่งเป็นธรรมเนียมที่ใช้ทั่วไปในเอกสารของ Kubernetes, docker-compose และ GitHub Actions