# Ejecutar aplicaciones Flask en Nginx

La configuración del servidor Nginx en `alumnos.cbtis227.edu.mx` permite ejecutar aplicaciones Flask a través de la siguiente URL:

<div align="center">
<code>https://alumnos.cbtis227.edu.mx/~‹usuario›/flask/‹proyecto›</code>
</div>
  
Donde:
- **`<usuario>`**: es el nombre de usuario en el servidor
- **`<proyecto>`**: es la carpeta que contiene la aplicación Flask

Existen dos entornos clave para visualizar la aplicación:

1.  **Entorno de Desarrollo**
    *   Para pruebas privadas donde podrás verificar avances y depurar el funcionamiento de tu proyecto.

2.  **Entorno de Producción**  
    *   Donde se publica el trabajo final para que esté disponible para todos los usuarios.

## Configuración de Puertos para Desarrollo

Para evitar conflictos durante el desarrollo, cada alumno utilizará un puerto específico según su número de lista:

### 🎯 Asignación de Puertos

- **Puerto base**: `5000`
- **Puerto personalizado**: `5000 + número_de_lista`

### 📋 Ejemplos de uso

| Alumno | N° Lista | Puerto | Comando |
|--------|----------|--------|---------|
| `jrobles` | 1 | **5001** | `python app.py --port 5001` |
| `mperez` | 2 | **5002** | `python app.py --port 5002` |
| `lgarcia` | 3 | **5003** | `python app.py --port 5003` |
| `ahernandez` | 4 | **5004** | `python app.py --port 5004` |

### 🚀 Ejecutar la aplicación en entorno de desarollo

#### Opción 1: Por argumento en línea de comandos
```bash
python app.py --port 5001 --debug
```

#### Opción 2: Con variable de entorno
```bash
export FLASK_RUN_PORT=5001
export FLASK_DEBUG=1
python app.py
```

#### Opción 3: En el mismo código
```bash
if __name__ == '__main__':
    app.run(debug=True, port=5001)  # Cambiar por tu puerto asignado
```

### 🚀 Configuración de Gunicorn para el entorno de producción

#### 📋 Requisitos previos

##### Estructura de directorios requerida:
```bash
# Crear directorios necesarios
mkdir -p ~/flask_apps/.sockets
mkdir -p ~/flask_apps/mi_proyecto
```
#### ⏰ Ejecución con nohup (Solución temporal)
##### Comando básico con nohup:
```bash
cd ~/flask_apps/mi_proyecto
nohup gunicorn --bind unix:/home/$USER/flask_apps/.sockets/mi_proyecto.sock app:app > ~/flask_apps/mi_proyecto.log 2>&1 &
```

##### Comando completo con configuración optimizada:
```bash
cd ~/flask_apps/mi_proyecto
nohup gunicorn \
  --bind unix:/home/$USER/flask_apps/.sockets/mi_proyecto.sock \
  --workers 2 \
  --timeout 60 \
  --access-logfile ~/flask_apps/mi_proyecto_access.log \
  --error-logfile ~/flask_apps/mi_proyecto_error.log \
  app:app > ~/flask_apps/mi_proyecto.log 2>&1 &
```

##### Verificar que está funcionando:
```bash
# Verificar el socket
ls -la ~/flask_apps/.sockets/mi_proyecto.sock

# Verificar procesos
ps aux | grep gunicorn

# Verificar logs
tail -f ~/flask_apps/mi_proyecto.log
```

##### Detener la aplicación:
```bash
pkill -f "gunicorn.*mi_proyecto"
```
#### ✔️ Configuración con systemd (Recomendado)
```bash
nano ~/.config/systemd/user/mi_proyecto.service
```
##### Contenido del servicio systemd:
```bash
[Unit]
Description=Gunicorn instance para mi_proyecto Flask app
After=network.target

[Service]
WorkingDirectory=/home/%USER/flask_apps/mi_proyecto
ExecStart=/home/%USER/flask_apps/mi_proyecto/venv/bin/gunicorn \
          --bind unix:/home/%USER/flask_apps/.sockets/mi_proyecto.sock \
          --workers 2 \
          --timeout 60 \
          app:app
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
Restart=always

[Install]
WantedBy=default.target
```
##### Comandos para gestionar el servicio:
```bash
# Recargar systemd
systemctl --user daemon-reload

# Habilitar inicio automático
systemctl --user enable mi_proyecto.service

# Iniciar servicio
systemctl --user start mi_proyecto.service

# Ver estado
systemctl --user status mi_proyecto.service

# Ver logs en tiempo real
journalctl --user-unit=mi_proyecto.service -f

# Reiniciar servicio
systemctl --user restart mi_proyecto.service

# Detener servicio
systemctl --user stop mi_proyecto.service
```
#### Para observar errores en la aplicación
```bash
journalctl --user -u mi_proyecto.service -p 3
```
La opción -p 3 en journalctl significa "mostrar mensajes con nivel de prioridad 3 o superior

#### 🔧 Configuración específica para el servidor
```bash
# Dar permisos al directorio de sockets
chmod 755 ~/flask_apps
chmod 755 ~/flask_apps/.sockets

# Verificar que el socket se crea correctamente
ls -la ~/flask_apps/.sockets/
```