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.
Đặ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.
Sửa JSON rồi chuyển lại YAML
- Trong ô JSON bên phải, đổi
"timeoutSeconds": 30bên trongpreviewthành"timeoutSeconds": 10. Giữ giá trị trongdefaultslà30. - 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.timeoutSecondsbên trái là10. - Để 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.
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.