GIT Guía Completa en Español – Colaboración con GIT

Repositorios Remotos

Los repositorios remotos son la clave para la colaboración en GIT. Son copias de tu repositorio que se encuentran almacenadas en un servidor externo, como GitHub, GitLab o Bitbucket. Permiten que múltiples desarrolladores trabajen en el mismo proyecto, compartan sus cambios y mantengan una copia de seguridad centralizada del código.

¿Por qué usar repositorios remotos?

• Colaboración: Facilitan el trabajo en equipo al permitir que varios desarrolladores trabajen en el mismo proyecto simultáneamente, fusionando sus cambios de manera controlada.
• Copia de Seguridad: Actúan como una copia de seguridad centralizada del proyecto, protegiendo tu código contra pérdidas accidentales o fallos en tu máquina local.
• Compartir Código: Te permiten compartir tu código con otros desarrolladores, ya sea para colaborar en proyectos de código abierto o para mostrar tu trabajo.
• Despliegue: Facilitan el despliegue de tu aplicación en servidores de producción o de pruebas.

Tipos de Repositorios Remotos:

• Origin: Es el nombre por defecto que se le asigna al repositorio remoto original del que clonaste tu repositorio local.
• Otros: Puedes añadir conexiones a otros repositorios remotos, lo que te permite colaborar con diferentes equipos o proyectos, o utilizar diferentes plataformas de alojamiento de código.

Operaciones con Repositorios Remotos:

• git remote add <nombre> <URL>: Añade una nueva conexión remota con el nombre especificado y la URL del repositorio remoto.
• git remote -v: Lista todas las conexiones remotas configuradas en tu repositorio local.
• git remote remove <nombre>: Elimina la conexión remota especificada.
• git remote rename <nombre-antiguo> <nombre-nuevo>: Renombra la conexión remota especificada.
• git push <remoto> <rama>: Envía los commits de tu rama local al repositorio remoto especificado.
• git pull <remoto> <rama>: Descarga los cambios de la rama especificada del repositorio remoto y los fusiona con tu rama local actual.
• git fetch <remoto>: Descarga los cambios del repositorio remoto sin fusionarlos, permitiéndote revisarlos antes de integrarlos.

Flujo de Trabajo con Repositorios Remotos:

• Clonar un repositorio remoto: git clone <URL-del-repositorio>
• Hacer cambios y commits localmente: Trabaja en tu repositorio local, realiza cambios, añade archivos al Staging Area y crea commits.
• Enviar tus cambios al repositorio remoto: git push origin <nombre-rama>
• Descargar los cambios de otros desarrolladores: git pull origin <nombre-rama>

Importancia de los Repositorios Remotos:

• Colaboración: Permiten que múltiples desarrolladores trabajen en el mismo proyecto de manera eficiente y sincronizada.
• Seguridad: Proporcionan una copia de seguridad centralizada del código, protegiéndolo contra pérdidas o daños.
• Compartir y Mostrar Código: Facilitan la compartición de código y la colaboración en proyectos de código abierto.
• Despliegue: Simplifican el proceso de despliegue de aplicaciones al permitir que los servidores de producción o de pruebas se mantengan actualizados con el código más reciente.

git remote – Gestionar repositorios remotos

El comando git remote es tu herramienta para establecer y administrar las conexiones entre tu repositorio local y los repositorios remotos que residen en servidores externos. Te permite agregar, listar, renombrar, eliminar y obtener información sobre estos repositorios remotos, facilitando la colaboración y la sincronización de tu trabajo con otros desarrolladores.

¿Qué hace git remote?

• git remote (sin argumentos): Lista los nombres de todos los repositorios remotos configurados en tu repositorio local.
• git remote add <nombre> <URL>: Añade una nueva conexión remota con el nombre especificado y la URL del repositorio remoto.
• git remote -v: Muestra una lista detallada de todas las conexiones remotas, incluyendo sus nombres, URLs y las ramas asociadas para fetching y pushing.
• git remote remove <nombre>: Elimina la conexión remota especificada.
• git remote rename <nombre-antiguo> <nombre-nuevo>: Renombra la conexión remota especificada.
• git remote show <nombre>: Muestra información detallada sobre una conexión remota específica, incluyendo las ramas, las URL de fetching y pushing, y otros detalles de configuración.

¿Cuándo usar git remote?

• Clonar un repositorio: Cuando clonas un repositorio remoto, GIT crea automáticamente una conexión remota llamada origin que apunta al repositorio original.
• Añadir un nuevo repositorio remoto: Cuando quieres colaborar con otros desarrolladores o utilizar un repositorio remoto diferente para copias de seguridad o despliegue.
• Listar repositorios remotos: Para ver una lista de todos los repositorios remotos configurados en tu proyecto.
• Eliminar o renombrar repositorios remotos: Cuando ya no necesitas una conexión remota o quieres cambiar su nombre.
• Obtener información sobre un repositorio remoto: Para ver los detalles de configuración de una conexión remota específica.

Ejemplos:

# Listar los repositorios remotos configurados
git remote

# Añadir un nuevo repositorio remoto llamado 'upstream'
git remote add upstream https://github.com/otro-usuario/otro-proyecto.git

# Mostrar detalles de la conexión remota 'origin'
git remote show origin

# Eliminar la conexión remota 'backup'
git remote remove backup

# Renombrar la conexión remota 'viejo-nombre' a 'nuevo-nombre'
git remote rename viejo-nombre nuevo-nombre

git fetch – Descargar cambios de un repositorio remoto sin fusionarlos

El comando git fetch te permite mantener tu repositorio local al día con los cambios realizados en un repositorio remoto, pero sin fusionarlos automáticamente en tu rama actual. Esto te da la flexibilidad de revisar los cambios antes de integrarlos, lo que es especialmente útil en entornos colaborativos donde quieres asegurarte de que los cambios externos no causen conflictos o problemas en tu trabajo local.

¿Qué hace git fetch?

• Descarga todos los nuevos commits, ramas y etiquetas del repositorio remoto especificado.
• Actualiza tus ramas remotas locales (por ejemplo, origin/main) para reflejar el estado actual del repositorio remoto.
• No modifica tu rama local actual ni el Working Tree. Los cambios descargados se mantienen en un área separada hasta que decidas fusionarlos manualmente.

¿Cuándo usar git fetch?

• Antes de fusionar: Para ver qué cambios han ocurrido en el repositorio remoto antes de fusionarlos con tu rama local, lo que te permite evaluar si hay conflictos potenciales o si necesitas actualizar tu trabajo antes de la fusión.
• Colaboración: Para mantenerte al tanto de los cambios realizados por otros desarrolladores sin afectar tu trabajo en curso.
• Flexibilidad: Para tener un mayor control sobre cuándo y cómo integrar los cambios remotos en tu rama local.

Cómo usar git fetch:

1. Asegúrate de tener una conexión remota configurada: Si aún no lo has hecho, utiliza git remote add origin <URL-del-repositorio> para añadir una conexión remota llamada origin que apunte al repositorio remoto del que quieres descargar los cambios.
2. Ejecuta el comando:
   • git fetch: Descarga todos los cambios de todas las ramas del repositorio remoto.
   • git fetch <remoto>: Descarga los cambios del repositorio remoto especificado.
   • git fetch <remoto> <rama>: Descarga los cambios de una rama específica del repositorio remoto.

Ejemplo:

Después de usar git fetch:

• Puedes usar git log main/<rama> para ver los commits descargados de la rama remota.
• Puedes usar git diff <rama-local> origin/<rama> para comparar tu rama local con la rama remota actualizada.
• Puedes usar git merge origin/<rama> para fusionar los cambios de la rama remota en tu rama local.

git pull vs git fetch

Aunque ambos comandos se utilizan para interactuar con repositorios remotos, git pull y git fetch tienen diferencias clave en su funcionamiento y en cuándo es apropiado utilizar cada uno.

git fetch

• Acción: Descarga los cambios del repositorio remoto (commits, ramas, etiquetas) pero NO los fusiona automáticamente en tu rama local actual.
• Resultado: Actualiza tus ramas remotas locales (e.g., origin/main) para reflejar el estado actual del repositorio remoto.
• Uso:
  • Para ver qué cambios han ocurrido en el repositorio remoto antes de integrarlos.
  • Para mantenerte al día con el trabajo de otros sin afectar tu rama local actual.
  • Cuando quieres tener un mayor control sobre cuándo y cómo integrar los cambios remotos.

git pull

• Acción: Es una combinación de dos comandos:
  • git fetch: Descarga los cambios del repositorio remoto.
  • git merge: Fusiona automáticamente los cambios descargados en tu rama local actual.
• Resultado: Actualiza tu rama local actual con los cambios del repositorio remoto.
• Uso:
  • Para actualizar rápidamente tu rama local con los últimos cambios del repositorio remoto.
  • Cuando confías en que los cambios remotos no causarán conflictos con tu trabajo local.
  • En flujos de trabajo donde la integración de cambios es frecuente y se espera que sea fluida.

Tabla comparativa:

¿Cuándo usar cada uno?

• git fetch:
  • Cuando quieres ver los cambios remotos antes de integrarlos.
  • Cuando estás trabajando en una rama con cambios importantes que no quieres mezclar accidentalmente con cambios remotos.
  • Cuando quieres tener un control más preciso sobre el proceso de fusión.
• git pull:
  • Cuando quieres actualizar rápidamente tu rama local con los últimos cambios remotos.
  • Cuando confías en que los cambios remotos no causarán conflictos.
  • En flujos de trabajo donde la integración de cambios es frecuente y se espera que sea fluida.

Pull Requests

Los Pull Requests (o solicitudes de extracción) son una funcionalidad esencial en plataformas de alojamiento de código como GitHub, GitLab o Bitbucket que facilitan la colaboración y la revisión de código en proyectos de software. Representan una propuesta formal para integrar los cambios de una rama en otra, generalmente de una rama de desarrollo a la rama principal (master o main).

¿Cómo funcionan los Pull Requests?

• Creación de una rama: Un desarrollador crea una nueva rama a partir de la rama principal para trabajar en una nueva funcionalidad, corrección de errores o mejora.
• Desarrollo y commits: El desarrollador realiza los cambios necesarios en su rama, añade los archivos al Staging Area y crea commits.
• Envío de la rama al repositorio remoto: El desarrollador utiliza git push para enviar su rama al repositorio remoto.
• Apertura del Pull Request: El desarrollador abre un Pull Request en la plataforma de alojamiento de código, especificando la rama que quiere fusionar y la rama destino.
• Revisión de código: Otros desarrolladores revisan los cambios propuestos en el Pull Request, hacen comentarios, sugieren mejoras y discuten el código.
• Discusión y mejoras: El autor del Pull Request y los revisores pueden discutir los cambios, hacer preguntas y solicitar aclaraciones. El autor puede realizar más commits en su rama para abordar los comentarios y sugerencias.
• Aprobación y fusión: Una vez que los revisores están satisfechos con los cambios, aprueban el Pull Request. El propietario del repositorio o un colaborador con permisos suficientes puede entonces fusionar la rama en la rama principal.
• Cierre del Pull Request: Una vez que la rama ha sido fusionada, el Pull Request se cierra automáticamente.

Ventajas de los Pull Requests:

• Revisión de Código: Facilitan la revisión de código entre compañeros de equipo, lo que ayuda a mejorar la calidad del código, detectar errores y garantizar la coherencia del proyecto.
• Colaboración: Promueven la colaboración y la comunicación entre desarrolladores, permitiendo discutir los cambios, hacer preguntas y compartir conocimientos.
• Trazabilidad: Mantienen un registro de todas las discusiones y decisiones relacionadas con los cambios propuestos, lo que facilita la comprensión del historial del proyecto y la toma de decisiones futuras.
• Control de Calidad: Permiten establecer flujos de trabajo de aprobación y control de calidad antes de integrar cambios en la rama principal, lo que ayuda a mantener la estabilidad del proyecto.

Lee el primer capítulo de esta guía aquí o lee la guía completa aquí.