Configuración — Desarrollo con el framework Django

• ¿Qué es la configuración de una aplicación?
• El enfoque de los 12 factores
• Qué son las variables de entorno
• Usar archivos .env con python-dotenv
• Configurar una base de datos vía variables

Imagina que ya llevas un buen rato desarrollando tu aplicación en Django y ahora necesitas conectarte a una base de datos remota, enviar correos electrónicos o integrar pagos. Para eso, necesitas guardar configuraciones como credenciales y claves de manera segura.

En este tema veremos cómo y dónde guardar esa configuración de forma segura y flexible.

¿Qué es la configuración de una aplicación?

Cuando una aplicación interactúa con el mundo exterior (por ejemplo, accede a una base de datos, envía correos o usa APIs de terceros), necesita ciertos parámetros:

Un error común es guardar esos datos directamente en archivos como settings.py. Veamos por qué esto es un problema:

❌ Algunos valores son confidenciales. Si alguien tiene acceso al código, también puede ver contraseñas y claves (grave problema de seguridad).

❌ Si cambias una clave o URL, debes modificar el código y hacer un nuevo despliegue, aunque el resto del sistema siga igual.

Por eso, se recomienda usar un enfoque más profesional...

El enfoque de los 12 factores

En 2011 la empresa Heroku propuso una guía llamada 12factor. Hay un punto clave que nos interesa:

➡️ Separar la configuración del código.

La idea es que el código sea el mismo en todos los entornos (desarrollo, pruebas, producción), y que la configuración cambie según el contexto.

¿Y cómo se pasa esa configuración desde afuera? Usando las llamadas variables de entorno.

Qué son las variables de entorno

Imagina que ponemos esto en settings.py:

import os

SECRET_KEY = os.environ['SECRET_KEY']

Al ejecutar el proyecto, Django intentará leer el valor de la variable de entorno SECRET_KEY. Si no existe, lanzará una excepción.

Este método es más seguro que escribir la clave directamente en el código, pero tiene algunos problemas:

❌ Si la variable no existe se genera un error (KeyError).

❌ Los valores siempre vienen como texto, entonces hay que convertirlos (por ejemplo, de "True" a True).

❌ Hay que definir estas variables en cada servidor manualmente.

Para simplificar esto, usamos una biblioteca muy útil...

Usar archivos .env con python-dotenv

La biblioteca python-dotenv te permite guardar variables de entorno en un archivo de texto llamado .env, y automáticamente las carga al entorno de ejecución.

Un archivo .env típico podría verse así:

DEBUG=True
SECRET_KEY=clave-super-secreta
DATABASE_URL=psql://usuario:clave@127.0.0.1:5432/mi_base

Este archivo no se sube al repositorio (se agrega al .gitignore), porque puede contener claves sensibles o configuraciones específicas por máquina.

Para integrarlo en Django, en tu archivo settings.py haces lo siguiente:

from dotenv import load_dotenv
import os

load_dotenv()  # Cargar las variables del archivo .env

SECRET_KEY = os.getenv('SECRET_KEY')
DEBUG = os.getenv('DEBUG') == 'True'

Así, simplificas el manejo de todas las claves y datos sensibles de configuración.

Configurar una base de datos vía variables

Cuando tú creas un proyecto en Django, por defecto viene con una base SQLite:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

Eso está bien para desarrollo, pero en producción seguramente vas a usar PostgreSQL u otro motor.
El problema: no debes codificar directamente esta configuración en settings.py.

Podrías extraer la URL desde una variable de entorno:

# .env
DATABASE_URL=psql://usuario:password@localhost:5432/mi_base

Y en tu settings.py, usamos la biblioteca dj-database-url:

import dj_database_url

DATABASES = {
    'default': dj_database_url.config(conn_max_age=600)
}

Gracias a esto, dj-database-url toma automáticamente DATABASE_URL y configura DATABASES por ti.

Si no has definido DATABASE_URL, puedes tener una base por defecto:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

db_from_env = dj_database_url.config(conn_max_age=600)
if db_from_env:
    DATABASES['default'].update(db_from_env)

Una vez tu proyecto esté en línea, manejar la configuración será más complejo, especialmente si usas varias máquinas.

Algunas herramientas que se usan para eso:

Estas herramientas permiten mantener claves fuera del código fuente y automatizar el despliegue para distintos ambientes (producción, pruebas, desarrollo, etc.).

Trabajo independiente

Materiales adicionales

1. Django settings