planetazuzu/codigo0

Fork 0

planetazuzu 0014c17873 Actualizar herramientas y contenidos

2026-01-19 09:10:16 +01:00

14 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.

Opciones de despliegue:

🐳 Docker (Recomendado) - Ver sección Despliegue con Docker
📦 PM2 + Node.js - Ver sección Despliegue con PM2

🐳 DESPLIEGUE CON DOCKER (Recomendado)

Ventajas de Docker

✅ Aislamiento completo de dependencias
✅ Reproducible en cualquier entorno
✅ Fácil actualización y rollback
✅ Gestión simplificada con docker-compose
✅ Health checks automáticos
✅ Recursos limitados (CPU/memoria)

Requisitos Previos Docker

Docker 20.10+ instalado
Docker Compose 2.0+ (o docker compose plugin)
Git instalado
Puerto 8607 disponible

Instalación Inicial con Docker

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 Docker

# Hacer ejecutable el script de deploy
chmod +x docker.sh

# Verificar que los archivos Docker existen
ls -la Dockerfile docker-compose.yml

4. Primer despliegue

# Deploy completo (con git pull + build + start)
./docker.sh

# O sin actualizar git (útil para webhooks)
./docker.sh --skip-git

Comandos Docker Útiles

# Deploy completo
./docker.sh

# Reconstruir imagen desde cero
./docker.sh --rebuild

# Ver logs en tiempo real
./docker.sh --logs
# O directamente:
docker-compose logs -f

# Detener contenedor
./docker.sh --stop
# O directamente:
docker-compose down

# Ver estado
docker ps | grep emerges-tes

# Entrar al contenedor (debug)
docker exec -it emerges-tes sh

# Ver uso de recursos
docker stats emerges-tes

Auto-Deploy con Docker

Opción 1: GitHub Actions + Docker

El workflow .github/workflows/deploy.yml puede actualizarse para usar Docker:

- name: Desplegar con Docker
  uses: appleboy/ssh-action@v1.0.3
  with:
    host: ${{ secrets.SERVER_HOST }}
    username: ${{ secrets.SERVER_USER }}
    key: ${{ secrets.SERVER_SSH_KEY }}
    script: |
      cd ${{ secrets.APP_PATH }}
      ./docker.sh --skip-git

Opción 2: Webhook + Docker

Actualizar webhook-deploy.sh para usar Docker:

# En webhook-deploy.sh, cambiar:
./deploy.sh --skip-git
# Por:
./docker.sh --skip-git

Opción 3: Cron + Docker

# Crear script
nano /usr/local/bin/check-github-updates-docker.sh

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

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

# Añadir a crontab
crontab -e
# Añadir:
*/5 * * * * /usr/local/bin/check-github-updates-docker.sh >> /var/log/docker-deploy.log 2>&1

Verificación y Monitoreo Docker

# Verificar que el contenedor está corriendo
docker ps | grep emerges-tes

# Ver logs
docker-compose logs -f emerges-tes

# Ver health check
docker inspect emerges-tes | grep -A 10 Health

# Ver uso de recursos
docker stats emerges-tes

# Verificar puerto
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

Solución de Problemas Docker

Error: "Cannot connect to Docker daemon"

# Añadir usuario al grupo docker
sudo usermod -aG docker $USER
# Reiniciar sesión o:
newgrp docker

Error: "Port 8607 already in use"

# Ver qué usa el puerto
sudo lsof -i :8607
# Detener contenedor anterior
docker-compose down

Error: "Build failed"

# Limpiar y reconstruir
docker-compose down
docker system prune -f
./docker.sh --rebuild

Contenedor se detiene inmediatamente

# Ver logs
docker-compose logs emerges-tes
# Verificar Dockerfile
cat Dockerfile

Configuración Avanzada Docker

Usar docker-compose.prod.yml para producción

# Usar archivo de producción
docker-compose -f docker-compose.prod.yml up -d

# O actualizar docker.sh para usar este archivo

Variables de entorno personalizadas

Crear .env:

NODE_ENV=production
PORT=8607

Y usar en docker-compose.yml:

env_file:
  - .env

Límites de recursos

Ya configurado en docker-compose.prod.yml:

CPU: 1.0 máximo, 0.5 reservado
Memoria: 512MB máximo, 256MB reservado

📦 DESPLIEGUE CON PM2 (Alternativa)

📋 Requisitos Previos (PM2)

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:

✅ Actualiza código desde GitHub (git pull)
✅ Instala dependencias (npm ci)
✅ Construye la aplicación (npm run build)
✅ 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:

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)
El workflow ya está configurado:
- Archivo: .github/workflows/deploy.yml
- Se ejecuta automáticamente en cada push a main
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:

Instalar dependencias en el servidor:

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

Configurar webhook handler:

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

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

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

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:

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

Hacer ejecutable:

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

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

Verificar GitHub Actions:
- Ve a: Actions en GitHub
- Ver si el workflow se ejecutó
- Revisar logs
Verificar webhook (si usas):
- Ve a: Settings > Webhooks en GitHub
- Ver últimos deliveries
- Revisar logs del servidor
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:

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

Última actualización: 2025-12-23

14 KiB Raw Blame History

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

🐳 DESPLIEGUE CON DOCKER (Recomendado)

Ventajas de Docker

Requisitos Previos Docker

Instalación Inicial con Docker

1. Instalar Docker

2. Clonar el repositorio

3. Configurar Docker

4. Primer despliegue

Comandos Docker Útiles

Auto-Deploy con Docker

Opción 1: GitHub Actions + Docker

Opción 2: Webhook + Docker

Opción 3: Cron + Docker

Verificación y Monitoreo Docker

Acceder a la aplicación

Solución de Problemas Docker

Configuración Avanzada Docker

Usar docker-compose.prod.yml para producción

Variables de entorno personalizadas

Límites de recursos

📦 DESPLIEGUE CON PM2 (Alternativa)

📋 Requisitos Previos (PM2)

🔧 Instalación Inicial

1. Instalar Node.js y npm

2. Instalar PM2

3. Clonar el repositorio

4. Configurar el script de deploy

🚀 Despliegue Manual

Opción 1: Script de Deploy Rápido

Opción 2: Deploy sin actualizar Git

🔄 Auto-Deploy desde GitHub

Opción 1: GitHub Actions (Recomendado) ⭐

Opción 2: Webhook de GitHub

Opción 3: Polling con Cron

🔍 Verificación y Monitoreo

Verificar que la app está corriendo

Acceder a la aplicación

🔒 Configurar Nginx como Reverse Proxy (Opcional)

🛠️ Comandos Útiles

PM2

Deploy

Git

🐛 Solución de Problemas

Error: "PM2 no está instalado"

Error: "Puerto 8607 ya en uso"

Error: "Build falla"

Error: "Git pull falla"

La app no se actualiza automáticamente

📝 Checklist de Despliegue

🔐 Seguridad

📞 Soporte

14 KiB

Raw Blame History