feat: Add staging environment for local production testing
- Add docker-compose.staging.yml with PostgreSQL and Django - Add .env.staging.example with staging-specific environment variables - Configure staging settings (DEBUG=False, no SSL redirect for localhost) - Update settings/__init__.py to support staging environment detection - Update AGENTS.md with staging environment documentation - Update .gitignore to exclude .env.staging - Optimize docker-compose.prod.yml configuration Staging environment simulates production configuration locally: - PostgreSQL database (port 5433 to avoid conflicts) - Gunicorn with 4 workers - DEBUG=False but HTTP allowed for easier testing - Separate volumes for static files, media, and logs Usage: cp .env.staging.example .env.staging docker compose -f docker-compose.staging.yml up -d
This commit is contained in:
72
AGENTS.md
72
AGENTS.md
@@ -8,9 +8,11 @@ Backend Django con Django REST Framework
|
||||
don_confiao_backend/
|
||||
├── requirements.txt # Dependencias Python
|
||||
├── docker-compose.dev.yml # Docker Compose para desarrollo
|
||||
├── docker-compose.staging.yml # Docker Compose para staging (testing producción local)
|
||||
├── docker-compose.prod.yml # Docker Compose para producción
|
||||
├── django.Dockerfile # Dockerfile Django
|
||||
├── .env.development # Variables de entorno desarrollo
|
||||
├── .env.staging # Variables de entorno staging
|
||||
├── .env.production.example # Ejemplo variables de entorno producción
|
||||
├── .env_example # Ejemplo de variables de entorno
|
||||
├── README.rst # Documentación básica
|
||||
@@ -42,6 +44,7 @@ don_confiao_backend/
|
||||
│ ├── __init__.py # Detección automática de ambiente
|
||||
│ ├── base.py # Configuración compartida
|
||||
│ ├── development.py # Configuración desarrollo
|
||||
│ ├── staging.py # Configuración staging
|
||||
│ └── production.py # Configuración producción
|
||||
├── urls.py
|
||||
├── wsgi.py
|
||||
@@ -86,20 +89,43 @@ El proyecto se ejecuta con docker-compose. Todos los comandos `manage.py` deben
|
||||
|
||||
```bash
|
||||
# Ejecutar tests
|
||||
docker-compose -f docker-compose.dev.yml run --rm django python manage.py test
|
||||
docker compose -f docker-compose.dev.yml run --rm django python manage.py test
|
||||
|
||||
# Migraciones
|
||||
docker-compose -f docker-compose.dev.yml run --rm django python manage.py makemigrations
|
||||
docker-compose -f docker-compose.dev.yml run --rm django python manage.py migrate
|
||||
docker compose -f docker-compose.dev.yml run --rm django python manage.py makemigrations
|
||||
docker compose -f docker-compose.dev.yml run --rm django python manage.py migrate
|
||||
|
||||
# Servidor desarrollo
|
||||
docker-compose -f docker-compose.dev.yml up
|
||||
docker compose -f docker-compose.dev.yml up
|
||||
|
||||
# Shell Django
|
||||
docker-compose -f docker-compose.dev.yml run --rm django python manage.py shell
|
||||
docker compose -f docker-compose.dev.yml run --rm django python manage.py shell
|
||||
|
||||
# Crear superuser
|
||||
docker-compose -f docker-compose.dev.yml run --rm django python manage.py createsuperuser
|
||||
docker compose -f docker-compose.dev.yml run --rm django python manage.py createsuperuser
|
||||
```
|
||||
|
||||
### Staging (Testing Producción Local)
|
||||
|
||||
```bash
|
||||
# Iniciar servicios (PostgreSQL + Django con Gunicorn)
|
||||
# Ya incluye el archivo .env.staging, listo para usar
|
||||
docker compose -f docker-compose.staging.yml up -d
|
||||
|
||||
# Migraciones
|
||||
docker compose -f docker-compose.staging.yml run --rm django python manage.py migrate
|
||||
|
||||
# Colectar archivos estáticos
|
||||
docker compose -f docker-compose.staging.yml run --rm django python manage.py collectstatic --noinput
|
||||
|
||||
# Crear superuser
|
||||
docker compose -f docker-compose.staging.yml run --rm django python manage.py createsuperuser
|
||||
|
||||
# Ver logs
|
||||
docker compose -f docker-compose.staging.yml logs -f django
|
||||
|
||||
# Detener servicios
|
||||
docker compose -f docker-compose.staging.yml down
|
||||
```
|
||||
|
||||
### Producción (Production)
|
||||
@@ -110,22 +136,22 @@ cp .env.production.example .env.production
|
||||
# Editar .env.production con valores reales
|
||||
|
||||
# Iniciar servicios (PostgreSQL + Django con Gunicorn)
|
||||
docker-compose -f docker-compose.prod.yml up -d
|
||||
docker compose -f docker-compose.prod.yml up -d
|
||||
|
||||
# Migraciones
|
||||
docker-compose -f docker-compose.prod.yml run --rm django python manage.py migrate
|
||||
docker compose -f docker-compose.prod.yml run --rm django python manage.py migrate
|
||||
|
||||
# Colectar archivos estáticos
|
||||
docker-compose -f docker-compose.prod.yml run --rm django python manage.py collectstatic --noinput
|
||||
docker compose -f docker-compose.prod.yml run --rm django python manage.py collectstatic --noinput
|
||||
|
||||
# Crear superuser
|
||||
docker-compose -f docker-compose.prod.yml run --rm django python manage.py createsuperuser
|
||||
docker compose -f docker-compose.prod.yml run --rm django python manage.py createsuperuser
|
||||
|
||||
# Ver logs
|
||||
docker-compose -f docker-compose.prod.yml logs -f django
|
||||
docker compose -f docker-compose.prod.yml logs -f django
|
||||
|
||||
# Detener servicios
|
||||
docker-compose -f docker-compose.prod.yml down
|
||||
docker compose -f docker-compose.prod.yml down
|
||||
```
|
||||
|
||||
Nota: El volumen monta `tienda_ilusion/` en `/app/`, por lo que el path correcto es `python manage.py` (no `python tienda_ilusion/manage.py`).
|
||||
@@ -143,7 +169,7 @@ Nota: El volumen monta `tienda_ilusion/` en `/app/`, por lo que el path correcto
|
||||
|
||||
## Configuración de Ambientes
|
||||
|
||||
El proyecto soporta dos ambientes diferentes mediante la variable `DJANGO_ENV`:
|
||||
El proyecto soporta tres ambientes diferentes mediante la variable `DJANGO_ENV`:
|
||||
|
||||
### Development (desarrollo local)
|
||||
- **Variable de ambiente**: `DJANGO_ENV=development`
|
||||
@@ -153,6 +179,16 @@ El proyecto soporta dos ambientes diferentes mediante la variable `DJANGO_ENV`:
|
||||
- **CORS**: Permisivo para desarrollo local
|
||||
- **Docker Compose**: `docker-compose.dev.yml`
|
||||
|
||||
### Staging (testing de producción local)
|
||||
- **Variable de ambiente**: `DJANGO_ENV=staging`
|
||||
- **Archivo de configuración**: `.env.staging`
|
||||
- **Base de datos**: PostgreSQL (tienda_ilusion_staging)
|
||||
- **DEBUG**: False (simula producción)
|
||||
- **CORS**: Permisivo para localhost (sin SSL redirect)
|
||||
- **Docker Compose**: `docker-compose.staging.yml`
|
||||
- **Servidor**: Gunicorn con 4 workers
|
||||
- **Puerto PostgreSQL**: 5433 (para no conflictuar con producción)
|
||||
|
||||
### Production (producción)
|
||||
- **Variable de ambiente**: `DJANGO_ENV=production`
|
||||
- **Archivo de configuración**: `.env.production` (crear desde `.env.production.example`)
|
||||
@@ -167,6 +203,7 @@ El proyecto soporta dos ambientes diferentes mediante la variable `DJANGO_ENV`:
|
||||
La detección de ambiente es automática mediante la variable `DJANGO_ENV`. Docker Compose configura esta variable automáticamente según el archivo usado:
|
||||
|
||||
- `docker-compose.dev.yml` → usa `.env.development` → carga `settings/development.py`
|
||||
- `docker-compose.staging.yml` → usa `.env.staging` → carga `settings/staging.py`
|
||||
- `docker-compose.prod.yml` → usa `.env.production` → carga `settings/production.py`
|
||||
|
||||
### Variables de entorno requeridas
|
||||
@@ -176,6 +213,15 @@ La detección de ambiente es automática mediante la variable `DJANGO_ENV`. Dock
|
||||
- `DEBUG=True`
|
||||
- `TRYTON_HOST`, `TRYTON_DATABASE`, `TRYTON_USERNAME`, `TRYTON_PASSWORD`
|
||||
|
||||
**Staging** (`.env.staging`):
|
||||
- `DJANGO_ENV=staging`
|
||||
- `DEBUG=False`
|
||||
- `SECRET_KEY` (para staging local, puede ser una key fija)
|
||||
- `ALLOWED_HOSTS=localhost,127.0.0.1,0.0.0.0`
|
||||
- `CORS_ALLOWED_ORIGINS` (URLs localhost separadas por comas)
|
||||
- `DB_NAME=tienda_ilusion_staging`, `DB_USER`, `DB_PASSWORD`, `DB_HOST=postgres`, `DB_PORT=5432`
|
||||
- `TRYTON_HOST`, `TRYTON_DATABASE`, `TRYTON_USERNAME`, `TRYTON_PASSWORD`
|
||||
|
||||
**Producción** (`.env.production`):
|
||||
- `DJANGO_ENV=production`
|
||||
- `DEBUG=False`
|
||||
|
||||
Reference in New Issue
Block a user