Tema 16 · Remotos

Vincular Repositorios Remotos con git remote

Aprende a conectar tu repositorio local con un repositorio alojado en GitHub mediante git remote add, listar conexiones remotas con git remote -v y cambiar URLs de conexión.

¿Qué es un Repositorio Remoto (Remote)?

Un remoto (remote) es un alias corto o apodo que Git asocia a una dirección web de un servidor externo (como GitHub, GitLab o Bitbucket). Por convención mundial, el servidor remoto principal de un proyecto casi siempre se bautiza con el nombre origin.

Vincular un Repositorio Local a GitHub

Cuando creas un repositorio vacío en GitHub, la plataforma te entrega dos URLs posibles para conectarlo:

  • Vía SSH (Recomendada): [email protected]:usuario/mi-proyecto.git
  • Vía HTTPS: https://github.com/usuario/mi-proyecto.git

Para crear el enlace en tu repositorio local, ejecutas:

git remote add origin [email protected]:solucionaticos/kilopolis-core.git

Comandos Esenciales de git remote

Comando Función
git remote Lista los nombres de los remotos configurados (ej: origin).
git remote -v Muestra la lista de remotos con sus URLs exactas de lectura (fetch) y escritura (push).
git remote set-url origin <nueva-url> Modifica la URL de un remoto (por ejemplo, para cambiar de HTTPS a SSH).
git remote remove origin Elimina la vinculación con el servidor remoto (no borra ningún archivo).

⚡ Comprobación y Modificación de Remotos en Terminal

Secuencia de comandos para vincular, verificar y cambiar la URL de un repositorio remoto:

vincular-remotos.sh
Solo lectura
# 1. Vincular el repositorio local a GitHub con el alias 'origin':
git remote add origin [email protected]:usuario/mi-proyecto.git

# 2. Verificar que el remoto quedó bien configurado con sus URLs:
git remote -v
# origin  [email protected]:usuario/mi-proyecto.git (fetch)
# origin  [email protected]:usuario/mi-proyecto.git (push)

# 3. Si en algún momento necesitas cambiar la URL (ej: de HTTPS a SSH):
git remote set-url origin [email protected]:usuario/mi-proyecto.git

# 4. Ver detalles completos del remoto (ramas rastreadas, estado):
git remote show origin
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Manual Completo de Git & GitHub Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de David Amador para Kilopolis Academia (Solucionáticos), estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.