codigo0/DEPLOYMENT_DOCKER.md

🐳 Guía de Despliegue con Docker

Esta guía explica cómo desplegar EMERGES TES usando Docker en tu servidor.

---

📋 Requisitos Previos

• Docker instalado (versión 20.10+)
• Docker Compose instalado (versión 2.0+) o Docker con compose plugin
• Git instalado
• Puerto 8607 disponible
• Acceso SSH al servidor (para auto-deploy)

---

🚀 Instalación Inicial

1. Instalar Docker

# Ubuntu/Debian
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Verificar instalación
docker --version
docker compose version

2. Clonar el Repositorio

cd /ruta/donde/quieres/la/app
git clone https://github.com/tu-usuario/guia-tes-digital.git
cd guia-tes-digital

3. Configurar Script de Deploy

# Hacer ejecutable
chmod +x deploy-docker.sh

# Probar el script manualmente
./deploy-docker.sh

---

🔧 Despliegue Manual

Opción 1: Script de Deploy (Recomendado)

./deploy-docker.sh

Este script:

1. ✅ Actualiza código desde GitHub (git pull)
2. ✅ Detiene contenedor existente
3. ✅ Construye imagen Docker
4. ✅ Inicia contenedor en puerto 8607

Opción 2: Docker Compose Directo

# Construir e iniciar
docker-compose up -d --build

# Ver logs
docker-compose logs -f

# Detener
docker-compose down

Opción 3: Docker Directo

# Construir imagen
docker build -t emerges-tes:latest .

# Ejecutar contenedor
docker run -d \
  --name emerges-tes \
  -p 8607:8607 \
  --restart unless-stopped \
  emerges-tes:latest

# Ver logs
docker logs -f emerges-tes

---

🔄 Auto-Deploy desde GitHub

Configurar GitHub Actions

1. Añadir Secrets en GitHub:

   • Ve a: Settings > Secrets and variables > Actions
   • Añade estos secrets:

     SERVER_HOST = tu-servidor-ip-o-dominio
     SERVER_USER = tu-usuario-ssh
     SERVER_SSH_KEY = (contenido de tu clave privada SSH)
     SERVER_PORT = 22 (o el puerto que uses)
     APP_PATH = /ruta/completa/a/tu/app
     

2. El workflow ya está configurado:

   • Archivo: .github/workflows/deploy-docker.yml
   • Se ejecuta automáticamente en cada push a main

3. Probar manualmente:

   • Ve a: Actions > Auto Deploy Docker to Server > Run workflow

---

🛠️ Comandos Útiles

Gestión de Contenedores

# Ver estado
docker ps | grep emerges-tes

# Ver logs
docker logs emerges-tes

# Ver logs en tiempo real
docker logs -f emerges-tes

# Reiniciar contenedor
docker restart emerges-tes

# Detener contenedor
docker stop emerges-tes

# Iniciar contenedor
docker start emerges-tes

# Eliminar contenedor
docker rm -f emerges-tes

Gestión de Imágenes

# Ver imágenes
docker images | grep emerges-tes

# Eliminar imagen antigua
docker rmi emerges-tes:latest

# Forzar rebuild
docker-compose build --no-cache

Docker Compose

# Iniciar
docker-compose up -d

# Detener
docker-compose down

# Reiniciar
docker-compose restart

# Ver logs
docker-compose logs -f

# Rebuild forzado
docker-compose up -d --build --force-recreate

---

🔍 Verificación y Monitoreo

Verificar que la App está Corriendo

# Verificar contenedor
docker ps | grep emerges-tes

# Verificar puerto
netstat -tlnp | grep 8607
# O
ss -tlnp | grep 8607

# Verificar salud
curl http://localhost:8607

Health Check

El contenedor incluye un health check automático:

# Ver estado de salud
docker inspect emerges-tes | grep -A 10 Health

Acceder a la Aplicación

• Local: http://localhost:8607
• Red: http://tu-servidor-ip:8607
• Dominio: http://tu-dominio.com:8607

---

🔒 Configurar Nginx como Reverse Proxy (Opcional)

Si quieres usar un dominio y puerto 80/443:

server {
    listen 80;
    server_name tu-dominio.com;

    location / {
        proxy_pass http://localhost:8607;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Luego:

sudo nginx -t
sudo systemctl reload nginx

---

🐛 Solución de Problemas

Error: "Docker no está instalado"

# Instalar Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Error: "docker-compose: command not found"

# Docker Compose V2 (plugin)
docker compose version

# O instalar Docker Compose V1
sudo apt-get install docker-compose

Error: "Puerto 8607 ya en uso"

# Ver qué proceso usa el puerto
sudo lsof -i :8607
# O
sudo netstat -tlnp | grep 8607

# Detener contenedor existente
docker stop emerges-tes
docker rm emerges-tes

Error: "Build falla"

# Limpiar caché de Docker
docker system prune -a

# Rebuild sin caché
docker-compose build --no-cache

Error: "Contenedor no inicia"

# Ver logs detallados
docker logs emerges-tes

# Verificar que dist/ existe en la imagen
docker run --rm emerges-tes:latest ls -la /app/dist

# Verificar Dockerfile
cat Dockerfile

La app no se actualiza automáticamente

1. Verificar GitHub Actions:

   • Ve a: Actions en GitHub
   • Ver si el workflow se ejecutó
   • Revisar logs

2. Verificar que el script se ejecutó:

   # En el servidor
   docker ps | grep emerges-tes
   docker logs emerges-tes | tail -20
   

---

📊 Ventajas de Docker

✅ Aislamiento: La app corre en su propio contenedor
✅ Consistencia: Mismo entorno en dev y producción
✅ Fácil despliegue: Un solo comando para desplegar
✅ Rollback fácil: Volver a imagen anterior
✅ Escalabilidad: Fácil de escalar horizontalmente
✅ Mantenimiento: Actualizar es tan simple como rebuild

---

🔄 Actualización Manual

# 1. Actualizar código
git pull origin main

# 2. Rebuild y reiniciar
./deploy-docker.sh --rebuild

# O manualmente:
docker-compose down
docker-compose build --no-cache
docker-compose up -d

---

📝 Checklist de Despliegue

• Docker instalado y funcionando
• Docker Compose instalado
• Repositorio clonado
• deploy-docker.sh es ejecutable
• Primer deploy manual exitoso
• App accesible en http://servidor:8607
• Auto-deploy configurado (GitHub Actions)
• Health check funcionando
• Logs accesibles

---

🔐 Seguridad

• ✅ No exponer Docker socket públicamente
• ✅ Usar HTTPS si es posible (Let's Encrypt)
• ✅ Configurar firewall (solo puertos necesarios)
• ✅ Mantener Docker actualizado
• ✅ Usar secrets de GitHub para credenciales SSH
• ✅ Limitar acceso SSH (solo desde IPs conocidas)

---

📞 Soporte

Si tienes problemas:

1. Revisar logs: docker logs emerges-tes
2. Verificar estado: docker ps | grep emerges-tes
3. Probar deploy manual: ./deploy-docker.sh
4. Verificar puerto: netstat -tlnp | grep 8607

---

Última actualización: 2024-12-19