Cómo enviar un proyecto existente a GitHub

Introducción

GitHub es una herramienta de gestión de Git alojada en la nube. Git es un control de versiones distribuido, lo que significa que todo el repositorio y el historial están activos dondequiera que los guardes. Las personas suelen usar GitHub en sus flujos de trabajo empresariales o de desarrollo como una solución de alojamiento gestionado para realizar copias de seguridad de sus repositorios. GitHub va aún más allá al permitirte conectar con colegas, amigos, organizaciones y más.

En este tutorial, aprenderá cómo tomar un proyecto existente en el que está trabajando y enviarlo a GitHub.

Requisitos previos

• Una cuenta gratuita de GitHub
• Git está instalado en su máquina local

Paso 1: Crear un nuevo repositorio de GitHub

Inicia sesión en GitHub y crea un nuevo repositorio vacío. Puedes elegir si quieres inicializar un README o no. Esto no importa, ya que, de todas formas, sobrescribiremos todo en este repositorio remoto.

Advertencia: En el resto de este tutorial, tu nombre de usuario de GitHub es Sammy y el repositorio que creaste se llama my-new-project. Es importante reemplazar estos lugares con tu nombre de usuario y el nombre del repositorio.

Paso 2 – Iniciar Git en la carpeta del proyecto

Después de navegar a la carpeta que desea agregar, ejecute los siguientes comandos desde su terminal.

Paso 3: Configurar el repositorio Git

Asegúrate de estar en el directorio raíz del proyecto que deseas enviar a GitHub y ejecuta:

Nota: Si ya tienes un repositorio Git básico, puedes omitir este comando.

git init

Este paso crea un directorio .git oculto en la carpeta del proyecto que el software git reconoce y utiliza para almacenar todos los metadatos y el historial de versiones del proyecto.

Agregar archivos al directorio Git

git add -A

El comando git add se utiliza para indicar a git qué archivos incluir en una confirmación, y el argumento -A (o –all) significa “incluir todos”.

Confirme los archivos agregados.

git commit -m 'Added my project'

El comando git commit crea una nueva confirmación con todos los archivos añadidos. -m (o -message) establece un mensaje que se incluirá con la confirmación y se utilizará como referencia futura para comprenderla. En este caso, el mensaje es: "He añadido mi proyecto".

Agregar una nueva fuente remota

git remote add origin [email protected]:sammy/my-new-project.git

Nota: Recuerde que debe reemplazar las partes resaltadas del nombre de usuario y del nombre del repositorio con su nombre de usuario y nombre del repositorio.

En Git, un "remoto" se refiere a una versión remota del mismo repositorio, generalmente ubicada en un servidor en algún lugar (en este caso, GitHub). "Origen" es el nombre predeterminado que Git le da a un servidor remoto (puede tener varios remotos), por lo que git remote add origin le indica a Git que agregue la URL predeterminada del servidor remoto para este repositorio.

Enviar a GitHub

git push -u -f origin main

El indicador -u (o --set-upstream) establece el origen remoto como referencia ascendente. Esto permite ejecutar comandos git push y git pull posteriormente sin tener que especificar el origen, como siempre queremos que haga GitHub en este caso.

El indicador -f (o –force) significa forzar. Reescribe automáticamente todo en el directorio remoto. Lo usamos aquí para sobrescribir el README predeterminado que GitHub inicializa automáticamente.

Nota: Si no incluiste el README predeterminado al crear el proyecto en GitHub, el indicador -f no es realmente necesario.

Juntos

git init
git add -A
git commit -m 'Added my project'
git remote add origin [email protected]:sammy/my-new-project.git
git push -u -f origin main

Resultado

Ahora, estás listo para rastrear los cambios de tu código de forma remota en GitHub.