comando remoto git: add, list, remove, change name url, protocol

En este artículo veremos cómo añadir, ver y borrar repositorios remotos, así como cambiar sus nombres y URLs, usando el comando git remote. Aunque git es genial por sí mismo, es cuando lo usas con un grupo de personas cuando realmente destaca. Echemos un vistazo a los comandos de git remote para empezar.

1. git remote add: Añadir/registrar/conectar un nuevo repositorio remoto

Cuando creas por primera vez un repositorio local usando el comando git init, no tendrás ningún repositorio remoto conectado. Si ejecutas el comando de abajo, que muestra una lista de todos los repositorios remotos conectados, no habrá salida.

$ git remote
 

Para compartir tu código fuente en tu entorno local con otros miembros del equipo, necesitas conectarte a un repositorio remoto. Un repositorio remoto puede ser un servidor que configures tú mismo, o puede utilizar un servicio como Github o Bitbucket.

De cualquier manera, e independientemente del protocolo de comunicación que utilices, el repositorio remoto tendrá una dirección que termina en .git. Usa esa dirección en el siguiente comando para añadir un nuevo repositorio remoto. Es una vieja convención añadir un repositorio remoto llamado origin si es el que sirve como repositorio principal.

Así que escribe el siguiente comando

$ git remote add origin [url]

Aquí está el resultado real de la ejecución

El comando git remote add se completa sin ninguna salida. Si verificas con el comando git remote después de introducirlo, verás el nombre origin en la lista.

Una opción común usada con el comando add es -f. Esta opción obtendrá automáticamente los datos de todas las ramas del repositorio recién añadido después de añadir el repositorio remoto.

Si recibe el mensaje de error remote origin already exists, significa que ya existe un repositorio remoto asociado con el nombre origin, así que por favor compruébelo y elimine el hook de renombrado. Puedes ver cómo hacerlo en las secciones siguientes.

2. git remote -v: Comprobar el nombre y la URL del repositorio remoto

El comando git remote tiene una opción -v (--verbose). Esta opción te permite imprimir información más detallada en la lista de repos remotos conectados.

$ git remote -v

Este es el aspecto del comando después de añadir otro repositorio remoto.

Junto con el nombre en la lista, también se imprime la URL. También puedes ver que el mismo nombre se imprime dos veces tanto para fetch como para push, lo que significa que en algunos casos es probable que las URLs para los dos usos sean diferentes. Las principales razones para usar diferentes direcciones son: hacer que un repositorio en particular sea de sólo lectura, bloquear la dirección push, o usar diferentes protocolos de comunicación.

Veremos cómo establecer cada dirección por separado en Sección 5 más adelante.

3. git remote remove: Eliminar un repositorio remoto

Aquí tienes cómo eliminar la conexión al repositorio remoto que has configurado. Simplemente ejecuta el siguiente comando.

$ git remote remove [name]

o

$ git remote rm [name]

Al eliminar un repositorio remoto también se eliminarán todas las ramas y configuraciones asociadas a él. La pantalla de ejecución tendrá el siguiente aspecto

4. git remote rename: Renombrar el repositorio remoto

A continuación, puedes cambiar el nombre que le diste al repositorio remoto. Puedes cambiarlo ejecutando el siguiente comando.

$ git remote rename [old_name] [new_name]

Cuando renombras un repositorio remoto, todas las ramas y configuraciones asociadas a él se actualizan también. Veamos la pantalla de ejecución

El nombre origin ha sido cambiado por onion.

5. git remote set-url: Cambia la URL del repositorio remoto [#5].

Aquí tienes un comando para cambiar la URL establecida para un nombre específico. Usa el siguiente comando.

$ git remote set-url [name] [new_url]

Por defecto, este comando cambia las direcciones fetch y push; sin embargo, si le das la opción --push, sólo podrás cambiar la URL push.

$ git remote set-url --push [name] [new_push_url]

Una vez cambiada la dirección URL PUSH, los comandos sin la opción --push sólo cambiarán la dirección URL FETCH. Comprueba el resultado de la ejecución para ver cómo se ha cambiado la dirección URL.

6. Introduciendo los 4 protocolos usados con repos remotos

Git soporta varios protocolos para comunicarse con repos remotos. Veamos cuatro de ellos.

6.1. local

Si un repositorio git está en el mismo sistema, puedes acceder a él a través del sistema de archivos. Esto es útil principalmente para pruebas o copias de seguridad locales.

Una dirección de ejemplo podría ser la siguiente

$ git remote add local_repo file:///path/to/local/repo.git

6.2. HTTP/HTTPS

HTTP(S) es un protocolo de comunicación popular para los servicios de alojamiento Git porque es el más común y no requiere configuración. También funciona bien con configuraciones como cortafuegos y proxies, y especialmente en el caso de HTTPS, tiene el beneficio añadido de la seguridad de los datos a través del soporte para encriptación.

Una dirección de ejemplo podría ser la siguiente

$ git remote add remote_repo https://example.com/user/repo.git

6.3. SSH

SSH es otro protocolo de comunicación popular porque soporta encriptación de clave pública/privada y puede ser más rápido que HTTP(S). Configurarlo por primera vez en Git es más complicado que HTTP(S), pero puede proporcionar beneficios de rendimiento para repositorios grandes. Por esta razón, está soportado por la mayoría de los servicios de alojamiento de Git.

Una dirección de ejemplo podría ser la siguiente

$ git remote add remote_repo ssh://user@example.com:/path/to/repo.git

6.4 Git

Git soporta su propio protocolo Git sobre TCP. Este protocolo no requiere autenticación de usuario ni encriptación, por lo que se suele utilizar para implementaciones de sólo lectura en la mayoría de proyectos de código abierto, incluido Git.

Una dirección de ejemplo podría ser la siguiente

$ git remote add remote_repo git://user@example.com:/path/to/repo.git

7. Conclusión

En este artículo, hemos cubierto casi todo lo que necesitas saber sobre el comando git remote, que es el punto de partida para trabajar con Git. El comando git remote es, en última instancia, el responsable de gestionar todos los repos remotos asociados a tu entorno Git local, Se utiliza junto con la mayoría de comandos relacionados con repos remotos, como git clone, git branch, git push, y git pull.

La gestión de repos remotos es algo que debe hacerse con cuidado, especialmente a medida que tu proyecto crece y requiere más atención a los detalles. Esperamos que este artículo te ofrezca un buen punto de partida para gestionar repos remotos.