Saltar al contenido
softperu.pe

Crear Repositorio Independiente - Espejo (Mirror)

El objetivo de crear un repositorio espejo es poder realizar cambios propios en un repositorio independiente y obtener los cambios continuos de un repositorio principal o raíz.

🚀 Pasos de Configuración Inicial

  1. Acceda a su cuenta y verifique que tenga acceso al repositorio principal o raíz.

Acceso al repositorio

  1. Cree un nuevo repositorio y consigne los datos necesarios.

Crear repositorio

Configurar el Espejo (Mirror)

  1. Diríjase a: Settings > Repository > Mirroring repositories.

Configuración de Mirroring

  1. En el campo Git repository URL, ingrese la ruta del repositorio principal. Considere agregar su usuario de GitLab en la URL, por ejemplo:

    https://usuario@gitlab.com/organizacion/proyecto.git

URL del repositorio espejo

  1. Configure los siguientes campos:
    • Mirror direction: Debe ser igual a Pull.
    • Password: Ingrese el password del usuario de la cuenta o el Personal Access Token (PAT) con permisos de lectura.
  2. Haga clic en el botón Mirror repository.

Guardar mirror

Luego de haberlo creado, visualizará el listado con el enlace activo:

Listado de mirrors

  1. Seleccione el botón de sincronización manual para probar:

Sincronizar cambios

Su repositorio se actualizará con los cambios del repositorio principal.

Recomendación

Para sincronizar manualmente su repositorio privado con los cambios del principal en cualquier momento, utilice el botón de actualización en la lista de mirrors.

Estado de sincronización

Hasta esta parte ya tendrá enlazado su repositorio propio con el repositorio principal o raíz.

🛠️ Flujo de Trabajo y Desarrollo Propio

Para realizar cambios en su repositorio propio, debe crear una nueva rama (branch). No realice commits directamente en la rama master/main, ya que esta es la rama que se sincroniza automáticamente desde el repositorio principal.

Para crear una rama de trabajo:

git checkout -b mi_rama

Después de realizar cambios o modificaciones del código, envíe sus cambios a su repositorio remoto:

git add .
git commit -m "feat: mi nueva funcionalidad personalizada"
git push origin mi_rama

Posteriormente, cuando necesite incorporar las últimas actualizaciones del repositorio principal:

  1. Diríjase a GitLab y pulse sincronizar en Mirroring repositories.

  2. Cámbiese a la rama principal localmente:

    git checkout master

  3. Actualice la rama master:

    git pull origin master

Pull de master

🔄 Fusión de Cambios (Merge)

Una vez actualizada la rama principal, regrese a su rama de trabajo para fusionar los cambios:

git checkout mi_rama
git merge master

Si surgen conflictos, resuélvalos en su editor de código. Finalmente, envíe la rama fusionada:

git add .
git commit -m "merge: integración de actualizaciones del núcleo"
git push origin mi_rama

Merge completado