Saltar al contenido principal
Version: ProX

Guía para Actualizar o Migrar el Sistema

⚠️ Migración de Servidor GitLab​

Hemos migrado nuestro servidor de GitLab. Si aún no has actualizado la URL del repositorio, te recomendamos verificar y cambiar la configuración antes de continuar.

Nueva URL: git.buho.la

📋 Pre Requisitos​

Antes de comenzar, asegúrate de tener:

  • Acceso SSH al servidor
  • Credenciales válidas de GitLab (usuario y token)
  • Permisos para ejecutar comandos Docker
  • Una suscripción activa para migrar su sistema ProX

1. Conexión al Servidor​

1.1 Acceso por SSH​

ssh [usuario]@[ip]

1.2 Verificar contenedores activos​

docker ps

1.3 Acceder al contenedor FPM​

docker exec -it [nombre_contenedor_fpm] /bin/bash

2. Preparación del Entorno​

💡 Tip: Antes de actualizar, siempre revisa si tienes cambios locales para evitar conflictos.

2.1 Verificar estado del repositorio​

git status

2.2 Guardar cambios locales (si los hay)​

git stash

2.3 Verificar la URL del repositorio remoto​

git remote -v

Si necesitas actualizar la URL:

git remote set-url origin https://git.buho.la/facturaloperu/facturador/pro-x.git

3. Actualización Estándar​

3.1 Descargar cambios​

git pull origin main

ℹ️ Nota: Si se solicitan credenciales, ingresa tu usuario y token de GitLab.

3.2 Recuperar cambios guardados (si aplicaste stash)​

git stash apply

3.3 Aplicar migraciones y optimizaciones​

Puedes ejecutar los comandos individualmente:

php artisan migrate
php artisan tenancy:migrate
php artisan config:cache
php artisan cache:clear
php artisan optimize:clear

O ejecutarlos en una sola línea:

php artisan migrate && php artisan tenancy:migrate && php artisan config:cache && php artisan cache:clear && php artisan optimize:clear

4. Migración del sistema ProX​

⚠️ Importante: Debes tener una suscripción activa para realizar esta migración. Si tu suscripción no está vigente, contacta al área comercial antes de continuar.

4.1 Respaldo de seguridad​

Antes de migrar, realiza copias de seguridad de:

  • Base de datos completa
  • Archivos del sistema
  • Configuraciones personalizadas

4.2 Verificar requisitos del sistema​

Confirma que tu servidor cumple con:

  • Versión mínima de PHP requerida
  • Extensiones PHP necesarias
  • Recursos de memoria y almacenamiento

4.3 Proceso de migración​

  1. Cambiar repositorio remoto:

    git remote set-url origin https://git.buho.la/facturaloperu/facturador/pro-x.git

  2. Verificar configuración:

    git remote -v

  3. Realizar migración completa:

    git status
    git add .
    git stash
    git pull origin main
    git reset --hard origin/main
    git stash apply

4.4 Verificación post-migración​

  • Confirma que todos los datos se migraron correctamente
  • Verifica el funcionamiento de las principales funcionalidades
  • Revisa y ajusta configuraciones según tus necesidades

5. Solución de Problemas Comunes​

Conflictos de merge​

Si encuentras conflictos durante git pull:

git status                    # Ver archivos en conflicto
# Resuelve manualmente los conflictos
git add .                     # Agregar cambios resueltos
git commit -m "Resolver conflictos de merge"

Problemas de permisos​

Si tienes problemas de permisos:

sudo chown -R www-data:www-data storage/
sudo chmod -R 755 storage/

Errores de dependencias​

Para actualizar dependencias:

composer update --no-dev
npm install && npm run production

6. Buenas Prácticas y Recomendaciones​

✅ Hacer siempre​

  • Crear respaldos antes de cualquier migración
  • Revisar logs de error durante el proceso
  • Probar funcionalidades críticas después de actualizar
  • Documentar cambios personalizados

⚠️ Precauciones​

  • El comando git reset --hard origin/main eliminará todos los cambios locales no guardados
  • Siempre usar git stash para preservar trabajo no confirmado
  • Verificar permisos de archivos después de actualizaciones

🚫 Evitar​

  • Actualizar en horarios de alta demanda
  • Saltar el proceso de respaldo
  • Ignorar mensajes de advertencia