Chuyển JSON thành YAML!

Nhập JSON để chuyển thành YAML dễ đọc! Hỗ trợ yml, Kubernetes, docker-compose, Spring application.yml.
JSON
Kết quả
 

Chuyển JSON thành YAML!

Công cụ này biến JSON thành YAML dựa trên thụt lề. Dấu ngoặc nhọn và phần lớn dấu nháy biến mất, giúp kết quả dễ bảo trì bằng tay hơn khi làm file cấu hình, và thứ tự key giữ đúng như trong JSON nguồn.

Nó giúp ích khi bạn chuyển một resource lấy bằng kubectl get -o json thành manifest, hoặc dán thiết lập nhận từ API vào docker-compose.yml, application.yml hay workflow của GitHub Actions.

Cách sử dụng

  1. Dán JSON vào ô JSON. Cú pháp không hợp lệ sẽ hiện JSON parsing failed ở kết quả; nếu cần, hãy chạy qua công cụ kiểm tra JSON trước.
  2. Xem lại YAML dưới Kết quả. Thụt lề là hai dấu cách.
  3. Sao chép vào file .yml, chỉnh độ sâu thụt lề nếu bạn lồng nó dưới một khối khác.

Ví dụ

Đầu vào (JSON)
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": ["8080:80"],
      "environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
    }
  }
}
Đầu ra (YAML)
services:
  web:
    image: nginx:1.27
    ports:
      - 8080:80
    environment:
      FEATURE_FLAG: "on"
      GREETING: |-
        hello
        world

Chuỗi "on" giữ dấu nháy: nếu viết trần là on, parser YAML 1.1 sẽ đọc nó thành boolean true. GREETING chứa xuống dòng nên được xuất thành khối |- hiển thị từng dòng đúng như đã viết.

Tính năng hỗ trợ

  • Việc đặt dấu nháy theo YAML 1.1. Các chuỗi như yes, no, on, off, y, n, ~, null, và những chuỗi trông giống giá trị khác như "0777", "1.0" hay "2024-01-01", được đặt trong dấu nháy để PyYAML (1.1) và các parser 1.2 hiện đại đọc ra cùng một giá trị.
  • Chuỗi như 22:22, thứ YAML 1.1 có thể đọc thành số hệ 60, cũng được đặt trong dấu nháy, tránh một lỗi kinh điển khi ánh xạ port trong docker-compose.
  • Chuỗi nhiều dòng thành khối literal |-.
  • Chuỗi dài không bao giờ bị gập (không giới hạn độ rộng dòng).
  • Mảng và object rỗng giữ nguyên là [] và {}.

Trường hợp sử dụng

Từ output JSON của kubectl sang manifest

Chuyển một Deployment hay ConfigMap lấy từ cluster dưới dạng JSON, xóa các field như status và metadata.uid, là bạn có manifest sẵn sàng đưa vào Git.

Viết application.yml cho Spring Boot

Một khối property nhận dưới dạng JSON từ config server hay tài liệu sẽ thành cây phân cấp YAML, nên bạn không phải tự thụt lề các key như spring.datasource.url.

Lưu ý và giới hạn

  • Không tạo comment, anchor (&) hay alias (*); một object lặp lại trong JSON cũng được lặp lại trong YAML.
  • Số nguyên lớn hơn 9007199254740991 bị mất độ chính xác do giới hạn số của JavaScript; hãy giữ ID dài dưới dạng chuỗi trong JSON.
  • Output là một document duy nhất. Với file nhiều resource phân tách bằng ---, hãy chuyển từng resource rồi tự nối lại.

Câu hỏi thường gặp

Vì sao có chuỗi được đặt trong dấu nháy, có chuỗi thì không?

Dấu nháy chỉ được thêm ở chỗ giá trị viết trần sẽ bị đọc thành kiểu khác. nginx:1.27 thế nào cũng là chuỗi, nhưng on, 010 và 22:22 biến thành boolean hoặc số ở một số parser, nên chúng được đặt trong dấu nháy.

Có apply output lên Kubernetes trực tiếp được không?

Cấu trúc hợp lệ nguyên trạng. Tuy vậy output từ kubectl get -o json mang theo các field do server điền như status, resourceVersion và managedFields, tốt nhất nên xóa chúng trước khi apply.

Có chuyển sang thụt lề bốn dấu cách được không?

Không có option này; thụt lề cố định ở hai dấu cách, quy ước được dùng xuyên suốt tài liệu của Kubernetes, docker-compose và GitHub Actions.