Jak spravujete nastavení v různých prostředích?

Question

Accepted Answer

Konfigurace Django je v `settings.py`, ale reálné aplikace potřebují **různá nastavení pro každé prostředí** (vývoj, staging, produkce) a musí **uchovávat tajemství mimo kód**. Správná správa je jak provozní nutností, tak požadavkem na bezpečnost.

## Problém s jedním settings.py

```python
# ❌ hardcoded, environment-mixed, and INSECURE settings
DEBUG = True                                    # must be False in production!
SECRET_KEY = "hardcoded-secret-in-code"          # ❌ secret committed to git
DATABASES = {"default": {"PASSWORD": "prod-pw"}} # ❌ production password in code
```

Napevno zakódované hodnoty míchají prostředí a — kriticky — commitují tajemství (SECRET_KEY, hesla do databáze, API klíče) do správy verzí, což je vážný bezpečnostní problém.

## Řešení 1: čtení konfigurace z proměnných prostředí

```python
import os
from pathlib import Path

SECRET_KEY = os.environ["DJANGO_SECRET_KEY"]    # from the environment, NOT code
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"],   # injected per environment
    }
}
# tools like django-environ / python-decouple make this cleaner (+ .env file support)
```

Čtení konfigurace (zejména tajemství) z **proměnných prostředí** ji uchovává mimo kód — stejný kódbase běží v jakémkoli prostředí s různými injektovanými hodnotami (přístup twelve-factor).

## Řešení 2: rozdělení souborů nastavení pro každé prostředí

```text
settings/
  base.py          # shared settings (apps, middleware, templates)
  development.py   # from base import *; DEBUG=True, local DB, debug toolbar
  production.py    # from base import *; DEBUG=False, security hardening, real DB
  test.py          # test-specific settings
```

```python
# production.py
from .base import *
DEBUG = False
ALLOWED_HOSTS = ["example.com"]
SECURE_SSL_REDIRECT = True            # production-only security settings
# select via: DJANGO_SETTINGS_MODULE=config.settings.production
```

Rozdělení nastavení na sdílený `base.py` plus soubory pro jednotlivá prostředí (vybrané přes `DJANGO_SETTINGS_MODULE`) čistě odděluje konfiguraci specifickou pro prostředí, zatímco sdílí společné nastavení.

## Kritická nastavení pro produkci

```python
DEBUG = False                  # ❗ NEVER True in production — leaks sensitive error info
ALLOWED_HOSTS = ["example.com"] # required when DEBUG=False
SECRET_KEY = os.environ[...]    # strong, secret, from the environment
# + SECURE_SSL_REDIRECT, SESSION_COOKIE_SECURE, HSTS, etc. for hardening
```

```text
✓ NEVER commit secrets — use env vars / a secret manager; gitignore .env
✓ DEBUG=False in production (DEBUG=True leaks tracebacks, settings → security risk)
✓ Commit a .env.example documenting required variables (no real values)
```

## Proč na tom záleží

Správa nastavení v různých prostředích je jak **provozní nutností**, tak **kritickou bezpečnostní praxí** pro jakoukoliv reálnou Django aplikaci.

Aplikace musí se chovat různě v různých prostředích — vývoj potřebuje `DEBUG=True` a pohodlná lokální nastavení, zatímco produkce vyžaduje `DEBUG=False`, bezpečnostní zpevnění, skutečné databáze a správné hostitele — a jeden napevno zakódovaný `settings.py` nemůže sloužit všem těmto účelům.

Je to hlavně **velký bezpečnostní problém**: napevno zakódovaná tajemství (SECRET_KEY, hesla do databáze, API klíče) se commitují do správy verzí, což je jeden z nejčastějších a nejzávaznějších bezpečnostních problémů (kdokoliv s přístupem k úložišti, nebo ve veřejném úložišti, získá klíče k vaší aplikaci a datům).

Porozumění řešením — čtení konfigurace a tajemství z **proměnných prostředí** (udržování je mimo kód, přístup twelve-factor, často s nástroji jako django-environ a gitignorovanými `.env` soubory) a **rozdělení nastavení** do sdíleného základu plus soubory pro jednotlivá prostředí — je nezbytné pro bezpečné a správné nasazení Django.

Znalost **kritických nastavení pro produkci** (obzvláště že `DEBUG` musí být `False` v produkci, jelikož `DEBUG=True` vystavuje stacktrace, cesty zdrojových kódů a nastavení útočníkům, plus `ALLOWED_HOSTS` a bezpečnostní zpevnění) je nezbytná pro produkční znalosti.

Dosažení správné správy nastavení — tajemství v prostředí, konfiguraci vhodnou pro prostředí, bezpečné výchozí hodnoty pro produkci — je základem pro profesionální provozování Django aplikací a vyhýbání se vážným zranitelnostem vyplývajícím z унiku tajemství nebo nesprávně nakonfigurovaných produkčních prostředí, což z toho činí důležitou, prakticky kritickou znalost pro jakékoliv reálné nasazení.