docs: 환경변수 관리 원칙 추가

This commit is contained in:
Claude-51124 2025-11-29 17:52:22 +09:00
parent dd578a42f7
commit c52a046f9d

View File

@ -168,7 +168,19 @@ utils
- 중간 과정은 DEBUG 레벨
- 프로덕션에서는 INFO 기본, DEBUG는 필요 시에만 활성화
## 12. 모범 사례 참고
## 12. 환경변수 관리 원칙
**단일 소스 원칙**:
- **`.env`**: 모든 환경변수 값의 단일 소스 (실제 값만 저장)
- **`docker-compose.yml`**: `env_file: - .env`로 자동 로드, `environment:` 섹션은 선택사항
- **`config.py`**: Pydantic Settings로 `.env` 자동 로드, 타입 검증 및 기본값만 담당
**금지 사항**:
- ❌ `.env`, `docker-compose.yml`, `config.py`에 동일한 변수를 중복 정의
- ❌ 코드에서 `os.getenv()` 직접 호출 (Pydantic Settings 사용)
- ❌ `docker-compose.yml``environment:` 섹션에 하드코딩된 값
## 13. 모범 사례 참고
본 문서는 FastAPI 커뮤니티의 다음 모범 사례를 반영하였습니다: