Blog

Chuyển YAML sang JSON để kiểm tra cách khai triển cấu hình chung

Dùng YAML có thời gian chờ và số lần thử lại chung để chuyển sang JSON trong trình duyệt, kiểm tra giá trị kế thừa và ghi đè, rồi sửa JSON và chuyển lại YAML. Tìm hiểu cách xử lý chú thích và anchor.

Giao diện tiếng Anh của công cụ YAML ⇄ JSON hiển thị YAML tham chiếu cấu hình chung cạnh JSON đã khai triển giá trị

Đặt thời gian chờ chung là 30 giây và số lần thử lại là 2, nhưng riêng môi trường xem trước dùng 0 lần thử lại. YAML cho phép tham chiếu cấu hình chung, song cấu hình càng dài thì càng khó lần theo nguồn gốc của từng giá trị. Công cụ chuyển đổi YAML ⇄ JSON giúp chuyển sang JSON để kiểm tra kết quả sau khi khai triển các tham chiếu.

Khai triển cấu hình chung của YAML thành JSON

Dán ví dụ sau vào ô “YAML” bên trái. Nếu dùng tệp, chọn chức năng nạp tệp YAML (“Load YAML file” trong giao diện tiếng Anh). &defaults đặt tên cho cấu hình chung, còn <<: *defaults nhập cấu hình đó vào preview.

# Shared request settings
defaults: &defaults
  timeoutSeconds: 30
  retries: 2
preview:
  <<: *defaults
  retries: 0

Bấm “YAML → JSON”. Kết quả xuất hiện trong ô “JSON” bên phải. preview.timeoutSeconds kế thừa giá trị 30 từ cấu hình chung, còn preview.retries nhận giá trị 0 vì thiết lập riêng được ưu tiên. defaults.retries vẫn là 2.

YAML bên trái có preview tham chiếu cấu hình chung; JSON bên phải khai triển timeoutSeconds 30 và retries 0 trong preview
Ví dụ trên giao diện tiếng Anh. Có thể kiểm tra các giá trị cuối cùng của preview ở bên phải.

Sửa JSON rồi chuyển lại YAML

  1. Trong ô JSON bên phải, đổi "timeoutSeconds": 30 bên trong preview thành "timeoutSeconds": 10. Giữ giá trị trong defaults là 30.
  2. Bấm nút kiểm tra bên phải (“Validate: JSON → YAML → JSON” trong giao diện tiếng Anh). YAML mới xuất hiện bên trái và kết quả kiểm tra nằm dưới các ô. Xác nhận preview.timeoutSeconds bên trái là 10.
  3. Để lưu kết quả thành tệp, sao chép nội dung ô cần dùng sang trình soạn thảo văn bản rồi lưu.
JSON với thời gian chờ của preview được đổi thành 10 giây, YAML sau chuyển đổi và thông báo kiểm tra thành công
Kiểm tra bắt đầu từ JSON sẽ đọc lại YAML đã chuyển đổi, so sánh cấu trúc và giá trị dữ liệu nhưng bỏ qua thứ tự khóa.

Khi cần giữ chú thích hoặc kiểu dữ liệu

JSON không chứa chú thích hay tên anchor của YAML gốc. Trong công cụ này, nếu dữ liệu JSON tương đương YAML gốc, bấm “JSON → YAML” trên cùng trang có thể khôi phục nguyên văn đã lưu. Nếu sửa giá trị như ví dụ này, công cụ tạo YAML mới từ dữ liệu đã khai triển. Muốn chỉ đổi thời gian chờ mà vẫn giữ chú thích và tham chiếu cấu hình chung, hãy thêm timeoutSeconds: 10 vào preview trong YAML gốc.

Kiểm tra bắt đầu từ YAML (“Validate: YAML → JSON → YAML”) xuất JSON và giữ lại nguyên văn YAML. Chẳng hạn, dù kiểm tra báo thành công với limit: .nan, JSON vẫn trở thành "limit": null. Khi chuyển cấu hình có yêu cầu về kiểu dữ liệu, cần kiểm tra trực tiếp cả giá trị sau chuyển đổi.