Chuyển tài liệu YAML (yml) sang JSON để thấy cấu trúc bị thụt lề che khuất và kiểu thực tế mà mỗi giá trị được parse thành. Anchor và alias được mở rộng thành giá trị thật, và nhiều document phân tách bằng --- được gom vào một mảng.
Nó đặc biệt tiện để bắt những lỗi YAML kinh điển: một giá trị gắn nhầm vào phần tử cha vì thiếu một dấu cách, hay version: 1.10 lặng lẽ thành số 1.1.
YAML, hoặc kéo thả file vào đó.Kết quả để xem mỗi giá trị đã thành chuỗi, số hay boolean, và sao chép nếu cần.name: ci
on:
push:
branches: [main]
defaults: &node
runs-on: ubuntu-latest
timeout-minutes: 10
jobs:
test: *node
{
"name": "ci",
"on": {
"push": {
"branches": [
"main"
]
}
},
"defaults": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
},
"jobs": {
"test": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
}
}
}Key on: của GitHub Actions vẫn là key chuỗi "on", vì công cụ này parse theo quy tắc YAML 1.2. Khối được định nghĩa với anchor &node được mở rộng ngay tại vị trí của *node.
yes, on và off vẫn là chuỗi, chỉ true/True/false mới thành boolean.~ và giá trị rỗng thành null; hex 0x1F và bát phân 0o17 thành số.&anchors và *aliases được phân giải thành giá trị được tham chiếu.| và folded > được chuyển thành chuỗi theo quy tắc xuống dòng của YAML.--- thành mảng JSON; một document duy nhất được xuất ra như chính giá trị của nó.Nếu env dưới containers bị thụt lề nông đi một cấp, nó lặng lẽ gắn vào field khác và bạn chỉ phát hiện lúc apply. Ở dạng JSON, dấu ngoặc nhọn cho thấy chính xác nó thuộc object nào.
Với script hay bundle front-end mà thêm parser YAML là quá mức, hãy chuyển cấu hình một lần rồi dùng dưới dạng import config from './config.json'.
Tài liệu OpenAPI viết bằng YAML dễ truy vấn bằng JSONPath hay jq hơn sau khi chuyển đổi, ví dụ để lấy ra schema ở một path cụ thể.
<<: *defaults) được áp dụng: key của mapping có anchor được sao chép vào, và key viết cạnh << sẽ ghi đè chúng. Parser chỉ hỗ trợ YAML 1.2 sẽ giữ << là key thường, nên kết quả có thể khác với các công cụ đó.2024-01-01 vẫn là chuỗi chứ không thành giá trị Date..inf và .nan không có cách biểu diễn trong JSON nên thành null.on và yes thành true, nên kết quả từ Python có thể khác.on của GitHub Actions hiện là "on" chứ không phải true?Trong YAML 1.2, boolean chỉ có true và false, nên on là chuỗi bình thường, cũng là cách GitHub Actions đọc key đó. PyYAML của Python theo 1.1 và biến nó thành key True, nên hãy cẩn thận khi parse workflow từ script.
version: 1.10 ra thành 1.1.1.10 không có dấu nháy là một con số trong YAML, và 1.10 bằng 1.1. Để giữ chuỗi phiên bản, hãy đặt nó trong dấu nháy ở YAML nguồn thành "1.10".
Mỗi document phân tách bằng --- thành một phần tử mảng theo thứ tự, nên file nhiều resource dùng với kubectl apply -f cho ra một mảng resource.