Guía para Migrar GitLab a un Nuevo Servidor

Esta guía detalla los pasos para migrar una instancia de GitLab a un nuevo servidor.

1. Actualiza la Instalación Actual

Asegúrate de que la versión de GitLab en el servidor antiguo esté actualizada para evitar problemas de compatibilidad durante la migración.

2. Configura el Nuevo Servidor

Instala GitLab en el nuevo servidor. Asegúrate de instalar la misma edición (comunitaria o empresarial) que la usada en el servidor antiguo. Por ejemplo, para la edición comunitaria:

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-ce

3. Crea una Copia de Seguridad

En el servidor antiguo, crea una copia de seguridad de GitLab:

sudo gitlab-backup create

La copia de seguridad se guardará en /var/opt/gitlab/backups/.

4. Transfiere los Archivos

Transfiere la copia de seguridad y otros archivos necesarios al nuevo servidor. Puedes usar scp o rsync:

rsync -vazP old.server:/etc/gitlab/ /etc/gitlab/

5. Restaura la Copia de Seguridad

En el nuevo servidor, detén los servicios de GitLab y restaura la copia de seguridad:

sudo gitlab-ctl stop puma
sudo gitlab-ctl stop sidekiq
sudo gitlab-backup restore BACKUP=nombre_del_backup_sin_extension

6. Verifica y Reconfigura

Reinicia GitLab y verifica que todo funcione correctamente:

sudo gitlab-ctl restart
sudo gitlab-rake gitlab:check SANITIZE=true
sudo gitlab-rake gitlab:doctor:secrets
sudo gitlab-rake gitlab:artifacts:check
sudo gitlab-rake gitlab:lfs:check
sudo gitlab-rake gitlab:uploads:check

Si es necesario, actualiza el nombre de dominio y reconfigura:

sudo gitlab-ctl reconfigure

Consideraciones Finales

Si encuentras errores relacionados con ramas no principales, usa el siguiente comando en gitlab-rails:

gitlab-rails c
Project.all.each {|p| p.change_head(p.default_branch) }

Juan José Fernández Durán

Arquitecto IT & Consultor IT

See author's posts