เปลี่ยนชื่อแบบ kebab-case เป็น SCREAMING_SNAKE_CASE: listen-port → LISTEN_PORT, max-body-size → MAX_BODY_SIZE นี่คือขั้นจากแฟล็ก CLI หรือคีย์ YAML ไปเป็น environment variable ที่ใช้ override ค่านั้น ซึ่งเป็นรูปแบบเบื้องหลังเครื่องมือที่รับทั้ง --log-format และ LOG_FORMAT
วางคีย์ของไฟล์คอนฟิกหรือแฟล็กจากผลลัพธ์ --help เพื่อให้ได้ชื่อตัวแปรที่ตรงกันสำหรับไฟล์ .env, Dockerfile และการตั้งค่า CI
--help ลงใน ข้อความตัวอักษรMYAPP_) ถ้าเครื่องมือของคุณต้องการlisten-port: 8080
log-format: json
max-body-size: 1mbLISTEN_PORT: 8080
LOG_FORMAT: json
MAX_BODY_SIZE: 1mbคีย์ YAML แต่ละตัวกลายเป็นชื่อ environment variable ตัวพิมพ์ใหญ่ ส่วนค่าอย่าง json และ 1mb ไม่ใช่ kebab-case จึงคงเดิม
log-format → LOG_FORMAT, retry-2-times → RETRY_2_TIMES-- ข้างหน้า ถูกปล่อยไว้ที่เดิมถ้า CLI ที่เขียนด้วย Go หรือ Rust ผูกแฟล็กกับ environment variable (อย่างที่ viper หรือ feature env ของ clap ทำได้) การแปลงรายการแฟล็กจะได้ชื่อตัวแปรไว้ใส่ในเอกสาร
เมื่อเซอร์วิสอ่าน listen-port จาก config.yaml แต่ก็ยอมให้ override ด้วย environment ชื่อที่แปลงแล้วคือสิ่งที่ใส่ลงใน docker-compose.yml หรือการตั้งค่า secret ของ CI
-- ขีดจะยังอยู่: --log-level → --LOG_LEVEL ให้วางชื่อโดยไม่มี prefixx-1 ก็ดูเหมือน kebab-case และกลายเป็น X_1 จึงไม่ควรใส่นิพจน์คำนวณในอินพุตAPP_ ให้ไหม?ไม่ ให้เติมในเอดิเตอร์ภายหลัง หรือใส่ไว้ในอินพุตเป็น app-listen-port
http2-enabled ล่ะ?แปลงได้เรียบร้อยเป็น HTTP2_ENABLED เพราะตัวเลขเป็นส่วนหนึ่งของช่วงแรก