214 lines
4.3 KiB
Markdown
214 lines
4.3 KiB
Markdown
# 🐳 Docker para Balotario Licencia A-I
|
|
|
|
Este directorio contiene la configuración de Docker para la aplicación Balotario.
|
|
|
|
## 📁 Archivos de Docker
|
|
|
|
### `Dockerfile`
|
|
**Imagen principal de la aplicación**
|
|
|
|
#### Características:
|
|
- ✅ **Base**: Python 3.11-slim (imagen ligera)
|
|
- ✅ **Usuario no-root** para seguridad
|
|
- ✅ **Multi-stage** optimizado para producción
|
|
- ✅ **Health check** integrado
|
|
- ✅ **Variables de entorno** configurables
|
|
|
|
### `docker-compose.yml`
|
|
**Orquestación de servicios**
|
|
|
|
#### Servicios incluidos:
|
|
- **balotario**: Aplicación Flask principal
|
|
- **nginx**: Proxy reverso (opcional)
|
|
|
|
### `nginx.conf`
|
|
**Configuración de Nginx**
|
|
|
|
#### Funcionalidades:
|
|
- ✅ **Proxy reverso** hacia Flask
|
|
- ✅ **Compresión gzip** para mejor rendimiento
|
|
- ✅ **Rate limiting** para protección
|
|
- ✅ **Headers de seguridad**
|
|
- ✅ **Cache de archivos estáticos**
|
|
|
|
## 🚀 Uso Rápido
|
|
|
|
### Opción 1: Docker Simple
|
|
```bash
|
|
# Construir imagen
|
|
docker build -t balotario .
|
|
|
|
# Ejecutar en desarrollo
|
|
docker run -p 5000:5000 -e FLASK_ENV=development balotario
|
|
|
|
# Ejecutar en producción
|
|
docker run -d -p 5000:5000 -e FLASK_ENV=production balotario
|
|
```
|
|
|
|
### Opción 2: Docker Compose (Recomendado)
|
|
```bash
|
|
# Iniciar todos los servicios
|
|
docker-compose up -d
|
|
|
|
# Ver logs
|
|
docker-compose logs -f
|
|
|
|
# Detener servicios
|
|
docker-compose down
|
|
```
|
|
|
|
### Opción 3: Script de Utilidades
|
|
```bash
|
|
# Usar el script helper
|
|
./scripts/docker.sh build
|
|
./scripts/docker.sh compose-up
|
|
./scripts/docker.sh logs
|
|
./scripts/docker.sh clean
|
|
```
|
|
|
|
## 🔧 Configuración
|
|
|
|
### Variables de Entorno
|
|
|
|
#### Para Desarrollo:
|
|
```bash
|
|
FLASK_ENV=development
|
|
FLASK_DEBUG=true
|
|
DOCKER_CONTAINER=true
|
|
```
|
|
|
|
#### Para Producción:
|
|
```bash
|
|
FLASK_ENV=production
|
|
FLASK_DEBUG=false
|
|
DOCKER_CONTAINER=true
|
|
SECRET_KEY=tu_clave_secreta_aqui
|
|
```
|
|
|
|
### Puertos
|
|
- **5000**: Aplicación Flask
|
|
- **80**: Nginx (si se usa)
|
|
- **443**: HTTPS (si se configura)
|
|
|
|
## 📊 Recursos
|
|
|
|
### Imagen Docker
|
|
- **Tamaño base**: ~150MB (Python slim)
|
|
- **Tamaño final**: ~200MB (con dependencias)
|
|
- **RAM recomendada**: 512MB mínimo
|
|
- **CPU**: 1 core suficiente
|
|
|
|
### Volúmenes
|
|
```yaml
|
|
volumes:
|
|
- ./data:/app/data:ro # Datos de solo lectura
|
|
- balotario-logs:/app/logs # Logs persistentes
|
|
```
|
|
|
|
## 🛡️ Seguridad
|
|
|
|
### Medidas Implementadas:
|
|
- ✅ **Usuario no-root** en el contenedor
|
|
- ✅ **Health checks** para monitoreo
|
|
- ✅ **Rate limiting** en Nginx
|
|
- ✅ **Headers de seguridad**
|
|
- ✅ **Secrets** via variables de entorno
|
|
|
|
### Recomendaciones Adicionales:
|
|
- 🔒 Usar **secrets de Docker** para claves
|
|
- 🔒 Configurar **HTTPS** con certificados
|
|
- 🔒 Implementar **logging** centralizado
|
|
- 🔒 Usar **registry privado** para imágenes
|
|
|
|
## 🚀 Despliegue
|
|
|
|
### Desarrollo Local
|
|
```bash
|
|
# Clonar proyecto
|
|
git clone <repo>
|
|
cd balotario-licencia-a1
|
|
|
|
# Iniciar con Docker Compose
|
|
docker-compose up -d
|
|
|
|
# Acceder a la aplicación
|
|
open http://localhost:5000
|
|
```
|
|
|
|
### Producción
|
|
```bash
|
|
# Variables de entorno
|
|
export FLASK_ENV=production
|
|
export SECRET_KEY=tu_clave_super_secreta
|
|
|
|
# Construir y ejecutar
|
|
docker build -t balotario:prod .
|
|
docker run -d -p 80:5000 \
|
|
-e FLASK_ENV=production \
|
|
-e SECRET_KEY=$SECRET_KEY \
|
|
--name balotario-prod \
|
|
--restart unless-stopped \
|
|
balotario:prod
|
|
```
|
|
|
|
### Con Nginx (Recomendado para Producción)
|
|
```bash
|
|
# Usar Docker Compose completo
|
|
docker-compose -f docker-compose.yml up -d
|
|
|
|
# Acceder via Nginx
|
|
open http://localhost
|
|
```
|
|
|
|
## 🐛 Troubleshooting
|
|
|
|
### Problemas Comunes
|
|
|
|
#### Puerto ocupado:
|
|
```bash
|
|
# Cambiar puerto en docker-compose.yml
|
|
ports:
|
|
- "8080:5000" # Usar puerto 8080 en lugar de 5000
|
|
```
|
|
|
|
#### Permisos:
|
|
```bash
|
|
# Verificar permisos de archivos
|
|
ls -la data/
|
|
chmod 644 data/balotario_clase_a_cat_I.md
|
|
```
|
|
|
|
#### Logs:
|
|
```bash
|
|
# Ver logs detallados
|
|
docker-compose logs -f balotario
|
|
docker logs balotario-prod
|
|
```
|
|
|
|
#### Limpiar todo:
|
|
```bash
|
|
# Limpiar completamente
|
|
./scripts/docker.sh clean
|
|
docker system prune -a
|
|
```
|
|
|
|
## 📈 Monitoreo
|
|
|
|
### Health Checks
|
|
```bash
|
|
# Verificar salud del contenedor
|
|
docker inspect balotario-prod | grep Health -A 10
|
|
|
|
# Endpoint de salud
|
|
curl http://localhost:5000/
|
|
```
|
|
|
|
### Métricas
|
|
- **CPU**: `docker stats balotario-prod`
|
|
- **Memoria**: `docker stats --no-stream`
|
|
- **Logs**: `docker logs --tail 100 balotario-prod`
|
|
|
|
---
|
|
|
|
**Nota**: Esta configuración está optimizada para facilidad de uso y seguridad básica. Para producción enterprise, considera usar Kubernetes o Docker Swarm.
|