Actualización y Mantenimiento

Cómo actualizar tu proyecto Astro cuando hagas cambios y comandos útiles para mantenimiento.

Actualizar Proyecto

Cuando hagas cambios en tu código local y lo subas a GitHub:

Opción 1: Comandos Manuales

# 1. Ir al directorio del proyecto
cd /root/tu-proyecto-astro

# 2. Descargar cambios de GitHub
git pull origin main

# 3. Reconstruir la imagen Docker
cd /root
docker compose build proyecto-astro

# 4. Reiniciar el contenedor con la nueva imagen
docker compose up -d proyecto-astro

# 5. Verificar que está corriendo
docker ps | grep proyecto-astro

Opción 2: Comando Rápido

cd /root/tu-proyecto-astro && git pull origin main && cd /root && docker compose up -d --build proyecto-astro && echo "✅ Actualización completada"

El flag -d (detached) hace que el contenedor se ejecute en segundo plano, liberando la terminal inmediatamente.

Opción 3: Script de Actualización Automatizado

# Crear script de actualización
vim /root/tu-proyecto-astro/update-docker.sh

Contenido:

#!/bin/bash
cd /root/tu-proyecto-astro

echo "📥 Descargando cambios..."
git pull origin main

echo "🔨 Reconstruyendo imagen..."
cd /root
docker compose build --no-cache proyecto-astro

echo "🔄 Reiniciando contenedor..."
docker compose up -d proyecto-astro

echo "🧹 Limpiando imágenes antiguas..."
docker image prune -f

echo "✅ Actualización completada"
echo "📊 Estado del contenedor:"
docker ps | grep proyecto-astro

# Dar permisos de ejecución
chmod +x /root/tu-proyecto-astro/update-docker.sh

# Ejecutar el script cuando quieras actualizar
/root/tu-proyecto-astro/update-docker.sh

Comandos Útiles

Ver Logs

# Ver logs en tiempo real (Ctrl+C para salir)
docker compose logs -f proyecto-astro

# Ver solo las últimas 50 líneas
docker compose logs --tail=50 proyecto-astro

# Ver logs con timestamps
docker compose logs -f --timestamps proyecto-astro

Gestión del Contenedor

# Reiniciar contenedor
docker compose restart proyecto-astro

# Detener contenedor
docker compose stop proyecto-astro

# Iniciar contenedor detenido
docker compose start proyecto-astro

# Eliminar contenedor (no elimina la imagen)
docker compose down proyecto-astro

# Ver uso de recursos en tiempo real
docker stats proyecto-astro

# Entrar al contenedor
docker exec -it proyecto-astro sh

Gestión de Imágenes

# Ver imágenes Docker
docker images | grep astro

# Limpiar imágenes no usadas
docker image prune -f

# Limpiar todo (imágenes, contenedores detenidos, etc.)
docker system prune -a

Solución de Problemas

Contenedor no inicia

# Ver logs detallados
docker compose logs proyecto-astro

# Ver eventos recientes
docker events --since 5m

Puerto ya en uso

# Ver qué usa el puerto
sudo lsof -i :3080

# Cambiar puerto en docker-compose.yml
ports:
  - "3081:80"  # Usar otro puerto

Imagen muy grande

# Ver tamaño de imagen
docker images proyecto-astro

# El multi-stage build ya optimiza el tamaño
# Limpiar capas innecesarias
docker image prune -a

Problemas con Traefik

# Ver logs de Traefik
docker compose logs -f traefik

# Verificar que el contenedor está en la red correcta
docker network inspect traefik_default

Backup del Proyecto

Backup de la Imagen

# Exportar imagen
docker save -o proyecto-astro-backup.tar proyecto-astro

# Importar imagen en otro servidor
docker load -i proyecto-astro-backup.tar

Backup del Código

El código está en GitHub, pero puedes hacer backup local:

# Desde tu máquina local
git clone git@github.com:tu-usuario/proyecto-astro.git proyecto-astro-backup

Monitoreo

# Ver estado de salud del contenedor
docker inspect --format='{{.State.Status}}' proyecto-astro

# Ver uso de recursos en tiempo real
docker stats proyecto-astro

# Ver información detallada del contenedor
docker inspect proyecto-astro

Mejores Prácticas

1. Hacer pull antes de editar para evitar conflictos
2. Probar cambios localmente antes de desplegar
3. Ver logs después de cada actualización
4. Mantener backup del código en GitHub
5. Limpiar imágenes antiguas regularmente
6. Monitorear recursos con docker stats

Múltiples Proyectos Astro

Si tienes varios proyectos Astro, cada uno debe tener:

• Su propia carpeta en /root/
• Su propio servicio en docker-compose.yml
• Su propio subdominio configurado
• Su propio contenedor independiente

Ejemplo con 2 proyectos:

  docs-astro:
    build:
      context: ./vps-docs
    container_name: docs-astro
    labels:
      - traefik.http.routers.docs-astro.rule=Host(`docs.tudominio.com`)
      # ... resto de labels

  portfolio-astro:
    build:
      context: ./portfolio
    container_name: portfolio-astro
    labels:
      - traefik.http.routers.portfolio-astro.rule=Host(`portfolio.tudominio.com`)
      # ... resto de labels

Cada proyecto se gestiona independientemente.