Saltar al contenido principal
Version: Pro7

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 de Pro6 a Pro7

Guías Disponibles​

Actualización Estándar

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

Migración Pro6 → Pro7

Para clientes que desean migrar desde Pro6 a la nueva versión Pro7. 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

Si necesitas actualizar la URL:

git remote set-url origin https://git.buho.la/facturaloperu/facturador/pro7.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 Pro6 a Pro7​

⚠️ 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 Cambiar repositorio remoto​

git remote set-url origin https://git.buho.la/facturaloperu/facturador/pro7.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

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"

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

🚫 Evitar​

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