환경 전반에 걸쳐 설정을 어떻게 관리하나요?

Question

Accepted Answer

Django 설정은 `settings.py`에 있지만, 실제 애플리케이션은 **환경별로 다른 설정**(개발, staging, production)이 필요하고 **비밀 정보를 코드에서 분리**해야 합니다. 이를 올바르게 관리하는 것은 운영상의 필요이자 보안 요구사항입니다.

## 단일 settings.py의 문제

```python
# ❌ 하드코딩되고, 환경이 섞이고, 안전하지 않은 설정
DEBUG = True                                    # production에서는 False여야 함!
SECRET_KEY = "hardcoded-secret-in-code"          # ❌ 비밀 정보가 git에 커밋됨
DATABASES = {"default": {"PASSWORD": "prod-pw"}} # ❌ production 비밀번호가 코드에
```

값을 하드코딩하면 환경이 섞이고, 결정적으로 비밀 정보(SECRET_KEY, 데이터베이스 비밀번호, API 키)를 버전 관리에 커밋합니다. 심각한 보안 침해입니다.

## 해결책 1: 환경 변수에서 설정 읽기

```python
import os
from pathlib import Path

SECRET_KEY = os.environ["DJANGO_SECRET_KEY"]    # 코드가 아닌 환경에서
DEBUG = os.environ.get("DJANGO_DEBUG", "False") == "True"
ALLOWED_HOSTS = os.environ.get("ALLOWED_HOSTS", "").split(",")
DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql",
        "NAME": os.environ["DB_NAME"],
        "PASSWORD": os.environ["DB_PASSWORD"],   # 환경별로 주입
    }
}
# django-environ / python-decouple 같은 도구가 이를 더 깔끔하게(+ .env 파일 지원)
```

설정(특히 비밀 정보)을 **환경 변수**에서 읽으면 코드에서 분리됩니다. 동일한 코드베이스가 다른 주입 값으로 어떤 환경에서나 실행됩니다(twelve-factor 접근).

## 해결책 2: 환경별 설정 파일 분리

```text
settings/
  base.py          # 공유 설정(app, middleware, template)
  development.py   # from base import *; DEBUG=True, 로컬 DB, debug toolbar
  production.py    # from base import *; DEBUG=False, 보안 강화, 실제 DB
  test.py          # 테스트 전용 설정
```

```python
# production.py
from .base import *
DEBUG = False
ALLOWED_HOSTS = ["example.com"]
SECURE_SSL_REDIRECT = True            # production 전용 보안 설정
# 선택: DJANGO_SETTINGS_MODULE=config.settings.production
```

설정을 공유 `base.py`와 환경별 파일(`DJANGO_SETTINGS_MODULE`로 선택)로 분리하면 공통 설정을 공유하면서 환경별 구성을 깔끔하게 분리합니다.

## 중요한 production 설정

```python
DEBUG = False                  # ❗ production에서 절대 True 금지 — 민감한 오류 정보 노출
ALLOWED_HOSTS = ["example.com"] # DEBUG=False일 때 필수
SECRET_KEY = os.environ[...]    # 강력하고 비밀, 환경에서
# + 강화를 위한 SECURE_SSL_REDIRECT, SESSION_COOKIE_SECURE, HSTS 등
```

```text
✓ 비밀 정보를 절대 커밋하지 말 것 — 환경 변수/비밀 관리자 사용; .env는 gitignore
✓ production에서 DEBUG=False(DEBUG=True는 트레이스백, 설정 노출 → 보안 위험)
✓ 필요한 변수를 문서화하는 .env.example 커밋(실제 값 없이)
```

## 왜 중요한가

환경 전반에 걸쳐 설정을 관리하는 것은 모든 실제 Django 애플리케이션에 대해 **운영상의 필요**이자 **중요한 보안 관행**입니다.

애플리케이션은 환경에 따라 다르게 동작해야 합니다—개발은 `DEBUG=True`와 편리한 로컬 설정이 필요하고, production은 `DEBUG=False`, 보안 강화, 실제 데이터베이스, 적절한 호스트가 필요합니다—단일 하드코딩된 `settings.py`는 이 모두를 충족할 수 없습니다.

더 중요하게, 이는 **주요 보안 관심사**입니다: 비밀 정보(SECRET_KEY, 데이터베이스 비밀번호, API 키)를 하드코딩하면 이를 버전 관리에 커밋하게 되며, 가장 흔하고 심각한 보안 침해 중 하나입니다(리포지토리 접근 권한이 있는 사람이라면, 또는 공개 리포지토리에서는 누구나 애플리케이션과 데이터의 열쇠를 얻습니다).

해결책—설정과 비밀 정보를 **환경 변수**에서 읽기(코드에서 분리, twelve-factor 접근, 종종 django-environ 같은 도구와 gitignore된 `.env` 파일 사용)와 설정을 공유 base와 환경별 파일로 **분리**하기—을 이해하는 것은 Django를 안전하고 올바르게 배포하는 데 필수적입니다.

**중요한 production 설정**(특히 `DEBUG`가 production에서 `False`여야 한다는 점, `DEBUG=True`는 트레이스백, 소스 경로, 설정을 공격자에게 노출하므로, 그리고 `ALLOWED_HOSTS`와 보안 강화)을 아는 것은 타협할 수 없는 production 지식입니다.

설정 관리를 올바르게 하는 것—비밀 정보는 환경에, 환경에 적합한 구성, 안전한 production 기본값—은 Django 애플리케이션을 전문적으로 운영하고 누출된 비밀 정보나 잘못 구성된 production 환경에서 오는 심각한 취약점을 피하는 데 기초적이며, 모든 실제 배포에 중요하고 실용적으로 결정적인 지식입니다.