Saltar a contenido

Migración GitLab → GitHub

El repositorio fue migrado de GitLab a GitHub. Este documento resume lo necesario para que el equipo y los servidores se reapunten al nuevo remoto.

  • URL anterior: https://gitlab.com/compulandia-ti/integrador.git (archivado, read-only)
  • URL nueva: git@github.com:CompulandiaTI/Integrador.git
  • Rama default: main
  • Ramas migradas: main, develop, staging, hquintero-dev, mvaliente-desa

master no fue migrada (estaba 507 commits atrás de main y sin uso desde abril 2025).

1. Aviso al equipo

Cada desarrollador con un clon local debe correr, una sola vez, los siguientes comandos en la raíz del proyecto:

# Reapuntar origin al nuevo remoto en GitHub
git remote set-url origin git@github.com:CompulandiaTI/Integrador.git

# Traer las ramas remotas y limpiar referencias viejas
git fetch --all --prune

# Verificar que el remoto apunta a GitHub
git remote -v

Reconfigurar el upstream tracking de cada rama

Al reapuntar origin, las ramas locales pueden perder la asociación con su rama remota. Para cada rama local que se mantenga activa:

git branch --set-upstream-to=origin/develop develop
git branch --set-upstream-to=origin/main main
git branch --set-upstream-to=origin/staging staging
# Solo si tenés la rama personal local correspondiente:
git branch --set-upstream-to=origin/hquintero-dev hquintero-dev
git branch --set-upstream-to=origin/mvaliente-desa mvaliente-desa

Verificación final

git branch -vv     # cada rama activa debe mostrar [origin/<rama>]
git status         # debe indicar "up to date with origin/<rama>"
git push --dry-run # debe responder "Everything up-to-date"

Acceso a GitHub

  • Solicitar invitación al repositorio CompulandiaTI/Integrador al administrador.
  • Configurar clave SSH en GitHub (Settings → SSH and GPG keys) o usar HTTPS con Personal Access Token.

2. Cambio del remoto en el servidor de producción

En producción se despliega desde la rama main. Para reapuntar el clon del servidor al nuevo origen:

# Ubicarse en el directorio del proyecto en el servidor
cd /ruta/al/proyecto

# Confirmar rama actual y estado limpio
git status
git branch --show-current   # debe ser: main

# Reapuntar origin a GitHub
git remote set-url origin git@github.com:CompulandiaTI/Integrador.git

# Verificar el cambio
git remote -v

# Traer cambios desde el nuevo remoto
git fetch origin --prune

# Reasegurar el tracking de main
git branch --set-upstream-to=origin/main main

# Confirmar que el pull funciona
git pull

Consideraciones para el servidor

  • Si el servidor usa HTTPS con credenciales guardadas en lugar de SSH, generar un Personal Access Token en GitHub y usarlo como password. La URL HTTPS sería https://github.com/CompulandiaTI/Integrador.git.
  • Si se usa SSH, asegurarse de que la clave pública del servidor esté agregada como Deploy Key en GitHub → Settings → Deploy keys del repositorio (read-only es suficiente para pull).
  • Revisar cualquier script de deploy que mencione gitlab.com y actualizar la URL.

3. Repositorio antiguo en GitLab

El repositorio GitLab quedó archivado (read-only). No se debe empujar más a GitLab. Se mantendrá como respaldo durante 1-2 meses antes de evaluar su eliminación definitiva.