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.
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.Kết quả. Thụt lề là hai dấu cách.{
"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
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.
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ị.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.|-.[] và {}.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.
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.
&) hay alias (*); một object lặp lại trong JSON cũng được lặp lại trong YAML.---, hãy chuyển từng resource rồi tự nối lại.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ấ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.
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.