¿Es usted un recién llegado a un equipo y se le ha indicado que descargue una rama remota del repositorio de código Git? Ya sea parte de una empresa en expansión o de un equipo compacto, dominar las ramas remotas de Git es clave para una colaboración de código fluida. En esta guía, profundice en el proceso de recuperación de código de un repositorio Git remoto, centrándose en el comando ‘git checkout remote branch’.

Requisitos previos

Otros posibles métodos de instalación para Windows incluyen chocolateado y Git4Win.

• Un repositorio Git remoto desde plataformas como GitLab, GitHubo Azure DevOps se requiere. Este artículo proporciona repositorios de muestra para una experiencia práctica, o puede utilizar el suyo propio.

Entendiendo una sucursal remota

Los repositorios de Git registran y rastrean una secuencia de confirmaciones relacionadas dentro de una rama. De forma predeterminada, una confirmación reside en la rama actualmente activa, generalmente denominada main o master.

Una sucursal remota es una sucursal ubicada en un repositorio Git remoto. Estos repositorios remotos, denominados “remotos”, son los destinos que su repositorio Git local buscará en busca de actualizaciones de confirmación externas una vez configurado.

Descubra las sucursales disponibles usando Git branch dominio. La rama marcada con un asterisco (*) es el activo. Las sucursales que se enumeran a continuación son únicamente locales ya que aún no se han recuperado sucursales remotas.

Dominar la rama remota de Git Checkout

Supongamos que tiene un repositorio Git local y surge la necesidad de colaborar con otros desarrolladores. Aquí es donde el git checkout El comando entra en juego, lo que le permite obtener las últimas confirmaciones de una rama remota en un repositorio Git remoto.

Una vez que se configura una sucursal remota, Git reflejará la sucursal remota en lugar de una sucursal solo local. A continuación se muestra un ejemplo del comando. git checkout remote <branch>.

Clonar el repositorio remoto de Git

Ahora que tiene un repositorio existente a su disposición, es hora de sumergirse. Siga los pasos a continuación para clonar el repositorio remoto en una carpeta local en su máquina.

1. A menudo es más sencillo clonar un repositorio remoto a través de la URL HTTPS en lugar de SSH para evitar problemas de certificados y firewall.

• Dirígete al repositorio en GitHub.
• Golpea el Código botón y seleccione HTTPS.
• Haga clic en el Portapapeles icono adyacente al enlace para copiar la URL a su portapapeles.

2. Después de copiar la URL HTTPS en su portapapeles, abra una interfaz de línea de comandos usando su CLI preferida, como el símbolo del sistema de Windows o el Terminal de Windows.

3. Navegue hasta la carpeta donde desea que resida el repositorio clonado. Para este tutorial, el git La carpeta en el directorio de inicio se utiliza como se muestra en las capturas de pantalla. Ejecute el siguiente comando para clonar el repositorioque crea una subcarpeta que alberga el repositorio remoto.

# GitHub git clone https://github.com/Adam-the-Automator/git-checkout-remote-branch

4. Vaya al repositorio clonado con el comando, cd git-checkout-remote-branch.

Ejecute lo siguiente comando de estado para asegurarse de que el repositorio se haya clonado correctamente. El idiota status El comando revela las diferencias entre la sucursal local y la sucursal remota, lo que ayuda a determinar si su sucursal está conectada y actualizada. El control remoto de Git predeterminado se denomina originantepuesto al main sucursal remota. git status

Para la mayoría del software Git moderno, main es la rama principal predeterminada. Es posible que encuentre una aplicación más antigua que utilice master para su nombre de rama predeterminado, pero ambos nombres son funcionalmente iguales. Este tutorial utiliza ramas llamadas main, RemoteBranch, SomeBranchy AnotherBranch.

¿Qué es un Git Remote y cómo rastrear sucursales remotas?

La clonación de un repositorio crea automáticamente una referencia a una fuente remota, conocido como control remoto. Esta referencia se utiliza para comprobar si hay nuevas confirmaciones o enviar nuevos cambios al repositorio remoto.

Un repositorio Git en sí puede tener varios controles remotos, pero una rama solo puede hacer referencia a un único control remoto.

El seguimiento de una sucursal remota establece una relación con una sucursal local. Esta relación le permite enviar o extraer confirmaciones sin esfuerzo desde la sucursal remota a la sucursal local. Además, una rama rastreada determina qué tan adelante o atrás está la rama local respecto de la remota en las confirmaciones.

Listado de los controles remotos de un repositorio Git

En primer lugar, asegúrese de que el repositorio con el que está trabajando tenga controles remotos de Git. Para hacer esto, vea los controles remotos de Git en su repositorio con el git remote comando como se muestra a continuación. En este caso, se muestran dos controles remotos, origin y remote2.

Se nombran dos repositorios remotos rastreados adicionales origin y remote2donde sus controles remotos pueden ser diferentes.

Para obtener más detalles sobre los controles remotos configurados, agregue el v cambie para mostrar el URI remoto completo de Git.

Quizás se pregunte por qué los URI separados para fetch y push. Algunos flujos de trabajo de Git le permiten buscar actualizaciones en un repositorio en un URI diferente al que puede enviar los cambios; esto se denomina flujo de trabajo triangular.

Visualización de sucursales remotas disponibles

Muestre todas las sucursales disponibles, tanto locales como remotas, en su repositorio con el branch dominio. Para mostrar también las ramas remotas, agregue el all interruptor, como se ejemplifica a continuación.

En la imagen de abajo, el repositorio remoto origen utilizado en este tutorial se muestra como se anticipó. No obstante, esta imagen omite todas las ramas del control remoto llamado Remoto2.

Si una sucursal en su control remoto no aparece en la lista de sucursales, debe actualizar su lista de sucursales remotas disponibles como se explica en la siguiente sección.

Actualización de las sucursales remotas disponibles

En ocasiones, un repositorio remoto puede agregar o modificar ramas. Para asegurarse de que está trabajando con las ramas más actualizadas, es necesario ejecutar el git fetch dominio.

El fetch El comando se conecta al repositorio remoto y recupera una lista de todas las ramas disponibles. Vea la publicación de sus sucursales actualmente rastreadas ejecutando el git fetch comando para ver que la rama remota ahora es visible, como se muestra a continuación.

# Retrieve available remote branches
git fetch

# Verify that all branches are now available on the local Git repository
git branch --all

Abajo, la sucursal remotes/origin/RemoteBranch ahora es visible en la lista de sucursales remotas disponibles después de ejecutar la git fetch dominio.

El fetch El comando solo busca actualizaciones del control remoto que actualmente se rastrea en la rama actual. Para que Git busque actualizaciones de todos los controles remotos en el repositorio, independientemente del estado de seguimiento, agregue el all parámetro.

Para recuperar las sucursales disponibles desde un control remoto específico, incluya el nombre del control remoto en el git fetch comando, como Remote2 en el siguiente ejemplo, que recupera la rama, main.

# List available branches in a local Git repository
git branch --all
# Fetch available branches from remote2
git fetch Remote2
# Verify that the remote2 branch, main, is now available
git branch --all

Cada vez que busque actualizaciones remotas con git fetch, git pullo git push, Git compara las confirmaciones con la rama remota. Las sucursales locales pueden rastrear cualquier sucursal remota de Git. Además, se pueden configurar varias sucursales locales para rastrear la misma sucursal remota.

Ver el seguimiento remoto de cada sucursal

Para ver la sucursal remota rastreada junto con la sucursal local correspondiente, utilice el vv parámetro con el comando git branch. Los resultados del comando muestran una lista de remotos y sucursales en el formato [<remote>/<branch>] como se ilustra a continuación.

Modificación del seguimiento remoto de una sucursal

Puede que sea necesario modificar su sucursal local para rastrear una sucursal remota diferente. Para configurar su sucursal actual en una sucursal remota específica, utilice el u parámetro, como se ilustra a continuación.

git branch -u Remote2/main

Comprobando las ramas remotas de Git

Con nuevas sucursales creadas en el repositorio remoto de Git, es posible que deba realizar una operación de sucursal remota de git checkout. La extracción de una rama de repositorio remoto se ejecuta a través del checkout dominio.

Si se cumplen las siguientes condiciones, Git determinará de forma autónoma el control remoto correcto, descargará una copia local de la rama remota y configurará la copia local para realizar un seguimiento de la rama remota. Verifique que las siguientes condiciones no se cumplan a través de los resultados de git branch --all dominio.

• Aún no existe una sucursal local con el mismo nombre.
• No existen varios controles remotos que utilicen el mismo nombre de rama remota.

Para realizar la operación de sucursal remota de git checkout, use el git checkout comando y escriba el nombre de la rama remota como se ve a continuación.

git checkout RemoteBranch

Si su repositorio local ya contiene una sucursal local con el mismo nombre, agregue el b parámetro para especificar un nombre de sucursal local alternativo antes de la sucursal remota para realizar el pago.

git checkout -b AnotherBranch origin/RemoteBranch

Si su repositorio local tiene varios controles remotos con el mismo nombre de rama, especifique contra qué control remoto y rama realizar el seguimiento de las confirmaciones locales.

git checkout --track origin/RemoteBranch

Es posible que las versiones futuras de Git prefieran que uses el git switch comando para cambiar y crear ramas. El idiota switch El comando es solo para ramas, mientras que el comando Git checkout tiene muchas capacidades. Irshad S. escribió un buen manual sobre el fundamento si desea leer más sobre esto.

Transferir una sucursal local a una remota

Al crear una sucursal local sin una sucursal remota correspondiente para el seguimiento, puede impulsar la sucursal al control remoto usando el git push dominio. El método más sencillo para establecer una nueva sucursal en su control remoto preferido es emplear el u parámetro.

El u El parámetro, como se utilizó anteriormente, necesita los argumentos del nombre del repositorio y la rama de origen. Al especificar únicamente HEAD como nombre de la rama de origen, Git comprende usar el nombre de la rama local actual como el nombre en el control remoto, en este caso, NewBranch.

# Checkout and switch to NewBranch
git checkout -b NewBranch
# Create NewBranch on the origin remote
git push -u origin HEAD
# Verify that the branches on the remote now exist
git branch -vv

HEAD es un atajo que simplemente significa la rama actual. Puede enviar otras ramas al control remoto y establecer el seguimiento usando su nombre en lugar de HEAD.

En ocasiones, el nombre de la sucursal local actual no coincide con el nombre de la sucursal remota. Para utilizar un nombre distinto, especifique el nombre de la rama deseada después de la fuente, unido por dos puntos, como se muestra a continuación.

# Create the current branch on the origin remote as AnotherBranch
git push -u origin HEAD:AnotherBranch
# Verify that the local NewBranch now exists as AnotherBranch on the origin remote
git branch -vv

Próximos pasos y recursos adicionales de Git

Después de haber revisado los conceptos básicos de Git, la administración de controles remotos y la realización de una sucursal remota de git checkout, ahora está equipado con una gran cantidad de conocimientos que le ayudarán a evitar futuras frustraciones. Los pasos para verificar la sucursal remota en Git y las mejores prácticas compartidas servirán como recursos invaluables en el futuro.

Si desea profundizar en otras facetas de la gestión de un repositorio Git, se recomiendan los siguientes recursos:

• Una introducción a las cabezas desprendidas: Descubra escenarios en los que un HEAD desprendido es beneficioso o involuntario, y cómo manejarlo.
• interruptor de git: Un comando dedicado a tratar con ramas, a diferencia del multifacético Git checkout.