Skip to main content

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

IMPORTANTE - Migración desde Pro 7

Si estás actualizando desde Pro 7 (rama main) a Pro 8, primero debes seguir los pasos del manual de migración:

👉 Manual de Upgrade Pro 7 a Pro 7.2

Nota: Puede actualizar directamente, pero debe tener en cuenta los cambios importantes en:

  • Dependencias del proyecto
  • Estructura de archivos y carpetas
  • Configuraciones del sistema

Se recomienda seguir el manual oficial para evitar problemas durante la migración.

📋 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 desde versiones anteriores

Guías Disponibles​

Actualización Estándar

Para usuarios que ya tienen Pro 8 y solo necesitan actualizar a la última versión.

Migración Pro 7 → Pro 8

Para clientes que desean migrar desde Pro 7 a la nueva versión Pro 8. Requiere suscripción activa.

Solución de Problemas

Ayuda para resolver errores comunes durante el proceso de actualización.

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

Necesitas actualizar la URL:

git remote set-url origin https://git.buho.la/facturaloperu/facturador/pro8.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 de Pro 7 a Pro 8​

⚠️ 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.

ATENCIÓN

Antes de migrar de Pro 7 a Pro 8, es obligatorio seguir el manual oficial de upgrade:

👉 Manual de Upgrade Pro 7 a Pro 8

Este manual incluye:

  • Actualización de dependencias
  • Cambios en la estructura del proyecto
  • Configuraciones específicas necesarias
  • Scripts de migración de base de datos

No omitas este paso o podrías experimentar errores críticos en el sistema.

4.1 Cambiar repositorio remoto​

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

4.2 Verificar configuración​

git remote -v

4.3 Proceso de 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
  • Comprueba que las nuevas dependencias de Pro 8 estén instaladas

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"

Errores de dependencias​

Si encuentras errores relacionados con dependencias después de actualizar:

composer install
composer dump-autoload

Precauciones y Recomendaciones​

⚠️ 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
  • Realizar backup completo antes de migrar de Pro 7 a Pro 8

🚫 Evitar​

  • Actualizar en horarios de alta demanda
  • Saltar el proceso de respaldo
  • Ignorar mensajes de advertencia
  • Migrar de Pro 7 a Pro 8 sin seguir el manual oficial