Chuyển YAML thành JSON!

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

Chuyển YAML thành JSON!

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.

Cách sử dụng

  1. Dán docker-compose.yml, manifest Kubernetes hoặc file workflow vào ô YAML, hoặc kéo thả file vào đó.
  2. Lỗi cú pháp hiện ở kết quả kèm số dòng và cột; hãy kiểm tra thụt lề ở vị trí đó trước tiên.
  3. Đọc JSON dưới Kết quả để xem mỗi giá trị đã thành chuỗi, số hay boolean, và sao chép nếu cần.

Ví dụ

Đầu vào (YAML)
name: ci
on:
  push:
    branches: [main]
defaults: &node
  runs-on: ubuntu-latest
  timeout-minutes: 10
jobs:
  test: *node
Đầu ra (JSON)
{
  "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.

Tính năng hỗ trợ

  • Parse theo core schema của YAML 1.2: 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.
  • Block scalar literal | và folded > được chuyển thành chuỗi theo quy tắc xuống dòng của YAML.
  • Nhiều document phân tách bằng --- thành mảng JSON; một document duy nhất được xuất ra như chính giá trị của nó.
  • Key xuất hiện hai lần trong cùng một mapping bị báo lỗi.

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

Kiểm tra thụt lề manifest Kubernetes

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.

Dùng cấu hình từ code

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'.

Xem xét spec OpenAPI

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ể.

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

  • Merge key (<<: *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ụ đó.
  • Ngày giờ như 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.
  • Comment không thể mang sang JSON nên bị bỏ.
  • PyYAML (YAML 1.1) đọc on và yes thành true, nên kết quả từ Python có thể khác.

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

Vì sao 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".

File chứa nhiều document thì sao?

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.