planetazuzu/codigo0
1
0
Fork 0
Code Issues Pull requests Actions 1 Packages Projects Releases Wiki Activity
codigo0/DEPLOYMENT_SERVER.md

8.9 KiB
Raw Blame History

🚀 Guía de Despliegue en Servidor (Puerto 8607)

Esta guía explica cómo desplegar EMERGES TES en tu servidor propio con auto-actualización desde GitHub.

📋 Requisitos Previos

  • Servidor Linux (Ubuntu/Debian recomendado)
  • Node.js 18+ instalado
  • npm instalado
  • PM2 instalado globalmente
  • Git instalado
  • Acceso SSH al servidor
  • Puerto 8607 disponible

🔧 Instalación Inicial

1. Instalar Node.js y npm

# Usando nvm (recomendado)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18

# O usando apt (Ubuntu/Debian)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

2. Instalar PM2

npm install -g pm2

3. Clonar el repositorio

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

4. Configurar el script de deploy

# Hacer el script ejecutable
chmod +x deploy.sh

# Probar el script manualmente
./deploy.sh

🚀 Despliegue Manual

Opción 1: Script de Deploy Rápido

./deploy.sh

Este script:

  1. ✅ Actualiza código desde GitHub (git pull)
  2. ✅ Instala dependencias (npm ci)
  3. ✅ Construye la aplicación (npm run build)
  4. ✅ Reinicia PM2 en puerto 8607

Opción 2: Deploy sin actualizar Git

Si ya tienes el código actualizado:

./deploy.sh --skip-git

🔄 Auto-Deploy desde GitHub

Tienes 3 opciones para auto-actualizar cuando haces push a GitHub:

Opción 1: GitHub Actions (Recomendado) ⭐

Ventajas:

  • ✅ No requiere configuración en el servidor
  • ✅ Ejecuta el build en GitHub (más rápido)
  • ✅ Historial de deployments en GitHub
  • ✅ Notificaciones automáticas

Configuración:

  1. Añadir secrets en GitHub:

    • Ve a: Settings > Secrets and variables > Actions
    • Añade estos secrets:
      • SERVER_HOST: IP o dominio de tu servidor
      • SERVER_USER: Usuario SSH (ej: root o ubuntu)
      • SERVER_SSH_KEY: Clave privada SSH (contenido completo)
      • SERVER_PORT: Puerto SSH (opcional, default: 22)
      • APP_PATH: Ruta completa donde está la app (ej: /home/usuario/guia-tes-digital)

  2. El workflow ya está configurado:

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

  3. Probar manualmente:

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

Nota: El workflow usa deploy.sh --skip-git porque el código ya está en el servidor.

Opción 2: Webhook de GitHub

Ventajas:

  • ✅ Ejecuta directamente en el servidor
  • ✅ Más control sobre el proceso

Configuración:

  1. Instalar dependencias en el servidor:

    sudo apt-get install -y jq  # Para parsear JSON

  2. Configurar webhook handler:

    # Editar webhook-deploy.sh
nano webhook-deploy.sh

# Cambiar:
SECRET="tu-secret-seguro-aqui"
APP_PATH="/ruta/completa/a/tu/app"

  3. Crear servicio webhook (usando Node.js simple o nginx):

    Opción A: Servidor Node.js simple (webhook-server.js):

    const http = require('http');
const { exec } = require('child_process');
const crypto = require('crypto');

const SECRET = 'tu-secret';
const PORT = 9000;
const APP_PATH = '/ruta/a/tu/app';

http.createServer((req, res) => {
  if (req.method === 'POST' && req.url === '/webhook') {
    let body = '';
    req.on('data', chunk => body += chunk);
    req.on('end', () => {
      const payload = JSON.parse(body);
      if (payload.ref === 'refs/heads/main') {
        exec(`cd ${APP_PATH} && ./deploy.sh --skip-git`, (error, stdout, stderr) => {
          console.log(stdout);
          if (error) console.error(stderr);
        });
      }
      res.writeHead(200);
      res.end('OK');
    });
  } else {
    res.writeHead(404);
    res.end('Not Found');
  }
}).listen(PORT);

    Ejecutar con PM2:

    pm2 start webhook-server.js --name webhook-deploy
pm2 save

  4. Configurar webhook en GitHub:

    • Ve a: Settings > Webhooks > Add webhook
    • Payload URL: http://tu-servidor:9000/webhook
    • Content type: application/json
    • Secret: (el mismo que configuraste en el script)
    • Events: Solo push

Opción 3: Polling con Cron

Ventajas:

  • ✅ Simple, no requiere configuración externa
  • ✅ Funciona sin abrir puertos adicionales

Configuración:

  1. Crear script de polling:

    nano /usr/local/bin/check-github-updates.sh

    #!/bin/bash
cd /ruta/a/tu/app
git fetch origin
if [ $(git rev-parse HEAD) != $(git rev-parse origin/main) ]; then
  ./deploy.sh
fi

  2. Hacer ejecutable:

    chmod +x /usr/local/bin/check-github-updates.sh

  3. Configurar cron (cada 5 minutos):

    crontab -e

    Añadir:

    */5 * * * * /usr/local/bin/check-github-updates.sh >> /var/log/github-poll.log 2>&1

🔍 Verificación y Monitoreo

Verificar que la app está corriendo

# Ver estado de PM2
pm2 list

# Ver logs en tiempo real
pm2 logs emerges-tes

# Ver monitor de recursos
pm2 monit

# Verificar que el puerto 8607 está escuchando
netstat -tlnp | grep 8607
# O
ss -tlnp | grep 8607

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

🛠️ Comandos Útiles

PM2

# Iniciar aplicación
pm2 start ecosystem.config.js

# Reiniciar aplicación
pm2 restart emerges-tes

# Detener aplicación
pm2 stop emerges-tes

# Ver logs
pm2 logs emerges-tes

# Ver logs de las últimas 100 líneas
pm2 logs emerges-tes --lines 100

# Reiniciar automáticamente al reiniciar el servidor
pm2 startup
pm2 save

Deploy

# Deploy completo (con git pull)
./deploy.sh

# Deploy sin git pull (útil para webhooks)
./deploy.sh --skip-git

# Ver qué haría el deploy sin ejecutarlo
bash -n deploy.sh  # Verifica sintaxis

Git

# Verificar estado
git status

# Ver últimos commits
git log --oneline -5

# Forzar actualización
git fetch origin
git reset --hard origin/main

🐛 Solución de Problemas

Error: "PM2 no está instalado"

npm install -g pm2

Error: "Puerto 8607 ya en uso"

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

# Detener PM2 y reiniciar
pm2 stop emerges-tes
pm2 restart emerges-tes

Error: "Build falla"

# Limpiar y reinstalar
rm -rf node_modules dist
npm ci
npm run build

Error: "Git pull falla"

# Verificar permisos
ls -la .git

# Verificar remoto
git remote -v

# Forzar actualización
git fetch origin
git reset --hard origin/main

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 webhook (si usas):

    • Ve a: Settings > Webhooks en GitHub
    • Ver últimos deliveries
    • Revisar logs del servidor

  3. Verificar cron (si usas):

    tail -f /var/log/github-poll.log

📝 Checklist de Despliegue

  • Node.js 18+ instalado
  • PM2 instalado globalmente
  • Repositorio clonado
  • deploy.sh es ejecutable
  • ecosystem.config.js configurado para puerto 8607
  • Primer deploy manual exitoso
  • App accesible en http://servidor:8607
  • Auto-deploy configurado (GitHub Actions, webhook, o cron)
  • PM2 configurado para iniciar al boot (pm2 startup)
  • Logs configurados y accesibles

🔐 Seguridad

  • ✅ No exponer secrets en el código
  • ✅ Usar HTTPS si es posible (Let's Encrypt)
  • ✅ Configurar firewall (solo puertos necesarios)
  • ✅ Mantener Node.js y dependencias actualizadas
  • ✅ Usar secrets de GitHub para credenciales SSH
  • ✅ Limitar acceso SSH (solo desde IPs conocidas)

📞 Soporte

Si tienes problemas:

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

Última actualización: 2024-12-19