forked from val-lop20/Pagina-de-Asistencia-MAC
Valeria López
513 lines
11 KiB
Markdown
513 lines
11 KiB
Markdown
# Guía de Despliegue a Producción
|
|
## Sistema de Asistencia MAC - FES Acatlán
|
|
|
|
Esta guía describe los pasos necesarios para desplegar el Sistema de Asistencia MAC en un entorno de producción.
|
|
|
|
---
|
|
|
|
## 📋 Requisitos del Servidor
|
|
|
|
### Hardware Mínimo Recomendado
|
|
- **CPU:** 2 cores
|
|
- **RAM:** 4 GB
|
|
- **Disco:** 20 GB SSD
|
|
- **Red:** Conexión estable a internet
|
|
|
|
### Software Requerido
|
|
- **Sistema Operativo:** Ubuntu 20.04+ / Debian 11+ / CentOS 8+
|
|
- **Docker:** Versión 20.10+
|
|
- **Docker Compose:** Versión 2.0+
|
|
- **Dominio:** (Opcional) Para acceso público con SSL
|
|
|
|
### Puertos Necesarios
|
|
- **80** (HTTP) - Nginx
|
|
- **443** (HTTPS) - Nginx con SSL (opcional pero recomendado)
|
|
- **5432** (PostgreSQL) - Solo si necesita acceso externo a la base de datos
|
|
|
|
---
|
|
|
|
## 🚀 Instalación Paso a Paso
|
|
|
|
### 1. Preparar el Servidor
|
|
|
|
#### Actualizar el sistema
|
|
```bash
|
|
sudo apt update && sudo apt upgrade -y
|
|
```
|
|
|
|
#### Instalar Docker
|
|
```bash
|
|
# Instalar dependencias
|
|
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
|
|
|
|
# Agregar repositorio oficial de Docker
|
|
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
|
|
|
|
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
|
|
|
|
# Instalar Docker
|
|
sudo apt update
|
|
sudo apt install -y docker-ce docker-ce-cli containerd.io
|
|
|
|
# Verificar instalación
|
|
docker --version
|
|
```
|
|
|
|
#### Instalar Docker Compose
|
|
```bash
|
|
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
|
|
|
|
sudo chmod +x /usr/local/bin/docker-compose
|
|
|
|
# Verificar instalación
|
|
docker-compose --version
|
|
```
|
|
|
|
#### Agregar usuario al grupo Docker (opcional)
|
|
```bash
|
|
sudo usermod -aG docker $USER
|
|
newgrp docker
|
|
```
|
|
|
|
---
|
|
|
|
### 2. Clonar el Proyecto
|
|
|
|
```bash
|
|
# Crear directorio para el proyecto
|
|
sudo mkdir -p /opt/mac-attendance
|
|
cd /opt/mac-attendance
|
|
|
|
# Clonar el repositorio
|
|
git clone <URL-DEL-REPOSITORIO> .
|
|
|
|
# O si recibiste el proyecto comprimido
|
|
# Descomprimir el archivo en /opt/mac-attendance
|
|
```
|
|
|
|
---
|
|
|
|
### 3. Configurar Variables de Entorno
|
|
|
|
```bash
|
|
# Copiar archivo de ejemplo
|
|
cp .env.example .env
|
|
|
|
# Editar con nano o vim
|
|
nano .env
|
|
```
|
|
|
|
#### Configuración CRÍTICA de Seguridad
|
|
|
|
**⚠️ IMPORTANTE:** Cambie TODOS estos valores antes de desplegar:
|
|
|
|
```env
|
|
# ==============================================
|
|
# Django Settings
|
|
# ==============================================
|
|
DEBUG=False
|
|
|
|
# Generar SECRET_KEY único (ejecutar este comando en Python):
|
|
# python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"
|
|
SECRET_KEY=<GENERAR-CLAVE-ALEATORIA-AQUÍ>
|
|
|
|
# Dominio o IP del servidor (separados por coma)
|
|
ALLOWED_HOSTS=midominio.com,www.midominio.com,IP_DEL_SERVIDOR
|
|
|
|
# ==============================================
|
|
# Security Settings
|
|
# ==============================================
|
|
RATELIMIT_ENABLE=True
|
|
SECURE_SSL_REDIRECT=True # Solo si tiene SSL configurado
|
|
SESSION_COOKIE_SECURE=True # Solo si tiene SSL configurado
|
|
CSRF_COOKIE_SECURE=True # Solo si tiene SSL configurado
|
|
|
|
# CORS y CSRF
|
|
CORS_ALLOWED_ORIGINS=https://midominio.com
|
|
CSRF_TRUSTED_ORIGINS=https://midominio.com
|
|
|
|
# ==============================================
|
|
# Database - PostgreSQL
|
|
# ==============================================
|
|
DB_NAME=mac_attendance
|
|
DB_USER=mac_user
|
|
DB_PASSWORD=<CONTRASEÑA-SEGURA-AQUÍ> # Cambiar por contraseña fuerte
|
|
DB_HOST=db
|
|
DB_PORT=5432
|
|
```
|
|
|
|
#### Generar SECRET_KEY Seguro
|
|
|
|
```bash
|
|
# Ejecutar dentro del contenedor después de construirlo la primera vez
|
|
docker-compose run --rm backend python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"
|
|
|
|
# Copiar el resultado y pegarlo en SECRET_KEY del archivo .env
|
|
```
|
|
|
|
---
|
|
|
|
### 4. Configurar PostgreSQL
|
|
|
|
Edite las credenciales de PostgreSQL en `docker-compose.yml` para que coincidan con su `.env`:
|
|
|
|
```bash
|
|
nano docker-compose.yml
|
|
```
|
|
|
|
Busque la sección de `db` y actualice:
|
|
```yaml
|
|
environment:
|
|
- POSTGRES_DB=mac_attendance
|
|
- POSTGRES_USER=mac_user
|
|
- POSTGRES_PASSWORD=<MISMA-CONTRASEÑA-DEL-ENV> # Debe coincidir con DB_PASSWORD
|
|
```
|
|
|
|
---
|
|
|
|
### 5. Construir e Iniciar los Contenedores
|
|
|
|
```bash
|
|
# Construir las imágenes
|
|
docker-compose build
|
|
|
|
# Iniciar los servicios en segundo plano
|
|
docker-compose up -d
|
|
|
|
# Verificar que todos los contenedores están corriendo
|
|
docker-compose ps
|
|
```
|
|
|
|
**Salida esperada:**
|
|
```
|
|
NAME STATUS
|
|
pagina-mac-og-backend-1 Up
|
|
pagina-mac-og-db-1 Up (healthy)
|
|
pagina-mac-og-nginx-1 Up
|
|
```
|
|
|
|
---
|
|
|
|
### 6. Aplicar Migraciones de Base de Datos
|
|
|
|
```bash
|
|
# Aplicar migraciones
|
|
docker-compose exec backend python manage.py migrate
|
|
|
|
# Verificar que no hay errores
|
|
```
|
|
|
|
---
|
|
|
|
### 7. Crear Superusuario (Administrador)
|
|
|
|
```bash
|
|
# Crear superusuario para acceder al panel de administración
|
|
docker-compose exec backend python manage.py createsuperuser
|
|
```
|
|
|
|
Siga las instrucciones e ingrese:
|
|
- **Username:** admin (o el que prefiera)
|
|
- **Email:** admin@mac.unam.mx (o su email)
|
|
- **Password:** (contraseña segura)
|
|
|
|
---
|
|
|
|
### 8. Recolectar Archivos Estáticos
|
|
|
|
```bash
|
|
# Recolectar archivos estáticos de Django
|
|
docker-compose exec backend python manage.py collectstatic --noinput
|
|
```
|
|
|
|
---
|
|
|
|
### 9. Verificar el Despliegue
|
|
|
|
```bash
|
|
# Ver logs en tiempo real
|
|
docker-compose logs -f
|
|
|
|
# Verificar logs del backend
|
|
docker-compose logs backend
|
|
|
|
# Verificar logs de nginx
|
|
docker-compose logs nginx
|
|
|
|
# Verificar logs de PostgreSQL
|
|
docker-compose logs db
|
|
```
|
|
|
|
#### Probar la Aplicación
|
|
|
|
1. Abrir navegador en: `http://IP_DEL_SERVIDOR` o `http://midominio.com`
|
|
2. Debería ver la página de login
|
|
3. Acceder al admin en: `http://IP_DEL_SERVIDOR/admin/`
|
|
4. Login con el superusuario creado
|
|
|
|
---
|
|
|
|
## 🔒 Configuración SSL (HTTPS) - Recomendado
|
|
|
|
### Opción 1: Con Let's Encrypt (Certbot)
|
|
|
|
```bash
|
|
# Instalar Certbot
|
|
sudo apt install -y certbot python3-certbot-nginx
|
|
|
|
# Obtener certificado SSL
|
|
sudo certbot --nginx -d midominio.com -d www.midominio.com
|
|
|
|
# El certificado se renovará automáticamente
|
|
```
|
|
|
|
### Opción 2: Con Certificado Propio
|
|
|
|
1. Copiar certificados SSL a `/opt/mac-attendance/ssl/`
|
|
2. Modificar `docker/nginx.conf` para incluir SSL
|
|
3. Reiniciar nginx: `docker-compose restart nginx`
|
|
|
|
---
|
|
|
|
## 🔧 Configuración de Firewall
|
|
|
|
```bash
|
|
# Permitir puertos necesarios
|
|
sudo ufw allow 22/tcp # SSH
|
|
sudo ufw allow 80/tcp # HTTP
|
|
sudo ufw allow 443/tcp # HTTPS
|
|
sudo ufw enable
|
|
|
|
# Verificar reglas
|
|
sudo ufw status
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 Backup y Recuperación
|
|
|
|
### Backup de Base de Datos
|
|
|
|
**Crear backup automático (recomendado):**
|
|
|
|
```bash
|
|
# Crear script de backup
|
|
sudo nano /opt/scripts/backup-mac-attendance.sh
|
|
```
|
|
|
|
Contenido del script:
|
|
```bash
|
|
#!/bin/bash
|
|
BACKUP_DIR="/opt/backups/mac-attendance"
|
|
DATE=$(date +%Y%m%d_%H%M%S)
|
|
BACKUP_FILE="$BACKUP_DIR/mac_attendance_$DATE.sql"
|
|
|
|
mkdir -p $BACKUP_DIR
|
|
docker-compose -f /opt/mac-attendance/docker-compose.yml exec -T db pg_dump -U mac_user mac_attendance > $BACKUP_FILE
|
|
gzip $BACKUP_FILE
|
|
|
|
# Mantener solo los últimos 30 días
|
|
find $BACKUP_DIR -type f -mtime +30 -delete
|
|
|
|
echo "Backup completado: $BACKUP_FILE.gz"
|
|
```
|
|
|
|
```bash
|
|
# Dar permisos de ejecución
|
|
sudo chmod +x /opt/scripts/backup-mac-attendance.sh
|
|
|
|
# Agregar a cron para ejecutar diariamente a las 2 AM
|
|
sudo crontab -e
|
|
```
|
|
|
|
Agregar línea:
|
|
```
|
|
0 2 * * * /opt/scripts/backup-mac-attendance.sh >> /var/log/mac-backup.log 2>&1
|
|
```
|
|
|
|
### Restaurar Backup
|
|
|
|
```bash
|
|
# Detener la aplicación
|
|
cd /opt/mac-attendance
|
|
docker-compose down
|
|
|
|
# Restaurar backup
|
|
gunzip backup_file.sql.gz
|
|
cat backup_file.sql | docker-compose exec -T db psql -U mac_user mac_attendance
|
|
|
|
# Reiniciar aplicación
|
|
docker-compose up -d
|
|
```
|
|
|
|
---
|
|
|
|
## 🔄 Actualización del Sistema
|
|
|
|
### Actualizar a Nueva Versión
|
|
|
|
```bash
|
|
cd /opt/mac-attendance
|
|
|
|
# Hacer backup antes de actualizar
|
|
docker-compose exec db pg_dump -U mac_user mac_attendance > backup_pre_update.sql
|
|
|
|
# Detener contenedores
|
|
docker-compose down
|
|
|
|
# Obtener nueva versión
|
|
git pull origin main
|
|
# O descomprimir nueva versión
|
|
|
|
# Reconstruir contenedores
|
|
docker-compose build
|
|
|
|
# Iniciar contenedores
|
|
docker-compose up -d
|
|
|
|
# Aplicar nuevas migraciones
|
|
docker-compose exec backend python manage.py migrate
|
|
|
|
# Recolectar archivos estáticos
|
|
docker-compose exec backend python manage.py collectstatic --noinput
|
|
|
|
# Verificar logs
|
|
docker-compose logs -f
|
|
```
|
|
|
|
---
|
|
|
|
## 📈 Monitoreo
|
|
|
|
### Ver Estado de Contenedores
|
|
|
|
```bash
|
|
docker-compose ps
|
|
```
|
|
|
|
### Ver Uso de Recursos
|
|
|
|
```bash
|
|
docker stats
|
|
```
|
|
|
|
### Ver Logs
|
|
|
|
```bash
|
|
# Todos los logs
|
|
docker-compose logs -f
|
|
|
|
# Solo backend
|
|
docker-compose logs -f backend
|
|
|
|
# Últimas 100 líneas
|
|
docker-compose logs --tail=100 backend
|
|
```
|
|
|
|
### Reiniciar Servicios
|
|
|
|
```bash
|
|
# Reiniciar todo
|
|
docker-compose restart
|
|
|
|
# Reiniciar solo backend
|
|
docker-compose restart backend
|
|
|
|
# Reiniciar solo nginx
|
|
docker-compose restart nginx
|
|
```
|
|
|
|
---
|
|
|
|
## ⚠️ Solución de Problemas
|
|
|
|
### Error: "502 Bad Gateway"
|
|
|
|
**Causa:** Backend no está respondiendo.
|
|
|
|
**Solución:**
|
|
```bash
|
|
# Verificar logs del backend
|
|
docker-compose logs backend
|
|
|
|
# Reiniciar backend
|
|
docker-compose restart backend
|
|
|
|
# Si persiste, reconstruir
|
|
docker-compose down
|
|
docker-compose up -d --build
|
|
```
|
|
|
|
### Error: "Connection refused" en PostgreSQL
|
|
|
|
**Causa:** Base de datos no está lista.
|
|
|
|
**Solución:**
|
|
```bash
|
|
# Verificar estado de PostgreSQL
|
|
docker-compose logs db
|
|
|
|
# Reiniciar base de datos
|
|
docker-compose restart db
|
|
|
|
# Esperar a que esté "healthy"
|
|
docker-compose ps
|
|
```
|
|
|
|
### Error: "CSRF verification failed"
|
|
|
|
**Causa:** Configuración incorrecta de dominios en .env
|
|
|
|
**Solución:**
|
|
```bash
|
|
# Verificar que ALLOWED_HOSTS y CSRF_TRUSTED_ORIGINS incluyen su dominio
|
|
nano .env
|
|
|
|
# Reiniciar backend
|
|
docker-compose restart backend
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 Checklist de Producción
|
|
|
|
Antes de poner en producción, verificar:
|
|
|
|
- [ ] **Seguridad:**
|
|
- [ ] DEBUG=False en .env
|
|
- [ ] SECRET_KEY único y aleatorio
|
|
- [ ] DB_PASSWORD seguro y único
|
|
- [ ] ALLOWED_HOSTS configurado correctamente
|
|
- [ ] SSL/HTTPS habilitado (recomendado)
|
|
- [ ] Firewall configurado
|
|
|
|
- [ ] **Base de Datos:**
|
|
- [ ] PostgreSQL corriendo y saludable
|
|
- [ ] Migraciones aplicadas
|
|
- [ ] Backup automático configurado
|
|
|
|
- [ ] **Aplicación:**
|
|
- [ ] Superusuario creado
|
|
- [ ] Archivos estáticos recolectados
|
|
- [ ] Aplicación accesible en navegador
|
|
- [ ] Login funcionando correctamente
|
|
|
|
- [ ] **Monitoreo:**
|
|
- [ ] Logs configurados
|
|
- [ ] Alertas configuradas (opcional)
|
|
- [ ] Backup verificado y probado
|
|
|
|
---
|
|
|
|
## 📞 Soporte Técnico
|
|
|
|
Para problemas durante el despliegue:
|
|
1. Revisar logs: `docker-compose logs -f`
|
|
2. Consultar documentación: `docs/`
|
|
3. Contactar a soporte técnico MAC
|
|
|
|
---
|
|
|
|
**Última actualización:** Octubre 2025
|
|
**Versión del documento:** 1.0
|