Conecta tu repositorio local a uno remoto y empuja (push) los cambios a este último.

Remotos (remotes)

Cuando pones algo en GitHub, esa copia vive en uno de los servidores de GitHub. Esto lo convierte en un repositorio remoto (remote) porque no está en tu ordenador, está en un servidor "remoto" en algún otro lugar. Empujando (pushing) tus cambios locales (los de tu ordenador) a éste, lo mantienes al día.

Otras personas siempre pueden obtener lo más reciente de tu proyecto tirando (pulling) de tus cambios desde el remoto (a otro ordenador). Así es cómo varias personas pueden trabajar juntas en un proyecto sin necesidad de tener acceso a tu ordenador, donde está almacenada tu copia local.

Un diagrama que muestra GitHub como servidor central que crea el sitio web GitHub.com. Dos ordenadores, uno a cada lado, están empujando (push) y tirando (pull) de GitHub.

Crear un repositorio remoto

Si quieres sincronizar tu versión local con la que está guardada en GitHub.com, primero crea un nuevo repositorio remoto (remote) en GitHub.com.

  • Ve a github.com, haz login, y haz clic en el '+' situado arriba a la derecha y después en 'Nuevo repositorio' ('New repository').
  • Dale un nombre que coincida con el nombre de tu repositorio local, 'hola-mundo', y una descripción corta.
  • Hazlo público. Esto significa que será listado en tu perfil público.
  • No inicialices con un archivo README porque ya tienes un archivo, localmente, llamado 'readme.txt'. Esta opción es una ayuda de GitHub si todavía no has creado uno local en tu ordenador.
  • Las opciones '.gitignore' and 'license' deben quedar en 'none' (ninguna). No las usaremos en este tutorial.
  • Haz clic en 'Create Repository' (crear repositorio).

Readmes, .gitignores y Licenses

Estos son archivos comunes en proyectos de código abierto, así que para iniciar un proyecto más fácilmente, GitHub ofrece una opción para crearlos por ti.

Un README describe lo que es el proyecto, cómo usarlo y, generalmente, cómo contribuir al mismo (algunas veces hay un archivo extra, 'CONTRIBUTING.md', para estos últimos detalles).

Un .gitignore es una lista de archivos a los que Git NO debería hacer seguimiento, por ejemplo, ¡archivos con contraseñas!

Un archivo license describe el tipo de licencia que pusiste en tu proyecto. Esto permite a otros saber cómo pueden usarlo. Puedes encontrar más información de los tipos de licencia en: choosealicense.com.

Conecta tu Local a tu Remoto

Ahora que has iniciado un repositorio remoto en GitHub.com, en la parte de arriba puedes ver una 'configuración rápida' ('Quick Setup'). Asegúrate de que el botón 'HTTPS' está seleccionado y copia la dirección, que es la dirección de tu repositorio en los servidores de GitHub.

Vuelve a la terminal, y situado dentro de la carpeta 'hola-mundo' que inicializaste como repositorio de Git en el reto anterior, vas a decirle a Git que recuerde la dirección de la versión remota en los servidores GitHub. Puedes tener varios remotos configurados en tu ordenador local, por lo que el remoto necesita un nombre. El remoto principal es generalmente llamado origin.

Para agregar un remoto llamado 'origin' a tu repositorio:

git remote add origin <URLDEGITHUB>

Tu repositorio local ahora sabe dónde está tu repositorio remoto, llamado 'origin', que está ubicado en los servidores de GitHub. Piensa en esto como si añadieras un nombre y un número de teléfono en los contactos de tu teléfono móvil para llamarlos rápidamente cada vez que te haga falta.

Usuarios de Windows:

Si tienes GitHub Desktop en tu ordenador, un remoto llamado 'origin' se crea automáticamente en tu repositorio local. En este caso, sólo necesitarás decirle qué URL asociar con 'origin'. Para esto, en vez de usar el comando 'add' mencionado anteriormente, utiliza el siguiente:

git remote set-url origin <URLDEGITHUB>

Empuja (push) tu trabajo al remoto

Lo siguiente es hacer push (empujar) todo lo que has hecho localmente a tu repositorio remoto en GitHub. Esto es algo que harás con frecuencia para que tu versión remota esté al día y coincida con el estado tu versión local.

Git tiene un sistema de ramas (branches) para que puedas trabajar en diferentes partes del proyecto en tiempos diferentes. Aprenderemos más acerca de ello después, pero por defecto la primera branch es nombrada 'master'. Cuando empujas (push) (y más adelante tiras) desde un proyecto, le dices a Git el nombre de la rama (branch name) que quieres y el nombre del remoto en el que debe residir.

En este caso, vamos a enviar una rama llamada 'master' a nuestro remoto en GitHub llamado 'origin'.

git push origin master

Ahora ve a la página de tu repositorio remoto en GitHub.com y actualízala. ¡Wow! Todo es lo mismo ahora en tu ordenador local y remotamente en GitHub. Felicidades, ¡has creado tu primer repositorio público!

Por favor, selecciona la carpeta en la que está tu repositorio.
  • Agregar conexiones remotas
  • git remote add <NOMBREDELREMOTO> <URL>
  • Modificar la URL de un remoto
  • git remote set-url <NOMBREDELREMOTO> <URL>
  • Tirar de los cambios
  • git pull <NOMBREDELREMOTO> <NOMBREDELBRANCH>
  • Ver las direcciones remotas
  • git remote -v
  • Empujar cambios
  • git push <NOMBREDELREMOTO> <BRANCH>