kebab-case 이름을 SCREAMING_SNAKE_CASE로 바꿉니다: listen-port → LISTEN_PORT, max-body-size → MAX_BODY_SIZE. CLI 옵션이나 YAML 키를 그것을 덮어쓰는 환경 변수로 옮기는 단계로, --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: 1mbYAML 키마다 대문자 환경 변수 이름이 되고, json, 1mb 같은 값은 kebab-case가 아니라서 그대로 남습니다.
log-format → LOG_FORMAT, retry-2-times → RETRY_2_TIMES.--를 포함해 이름 주변 글자는 그대로 둡니다.viper나 clap의 env 기능처럼 Go·Rust CLI가 옵션을 환경 변수와 연결한다면, 옵션 목록을 바꿔서 문서에 적을 변수 이름을 얻을 수 있습니다.
서비스가 config.yaml에서 listen-port를 읽고 환경 변수로도 덮어쓸 수 있다면, 변환한 이름이 docker-compose.yml이나 CI 시크릿 설정에 들어갈 이름입니다.
--와 함께 넣으면 대시가 남습니다: --log-level → --LOG_LEVEL. 접두어 없이 이름만 넣어 주세요.x-1 같은 짧은 계산식도 kebab-case처럼 보여 X_1이 됩니다. 계산식은 넣지 마세요.APP_ 같은 접두어를 붙여 주나요?아니요. 나중에 편집기에서 붙이거나 입력을 app-listen-port처럼 넣으세요.
http2-enabled 같은 키는요?숫자가 첫 구간에 붙어 있어서 HTTP2_ENABLED로 깔끔하게 바뀝니다.