¡Bienvenido a esta guía de aprendizaje de Git y GitHub! En este documento, te proporcionaremos una introducción básica a las principales funcionalidades de Git y cómo utilizar GitHub para colaborar en proyectos de desarrollo de software. A lo largo del documento, exploraremos conceptos clave y te mostraremos ejemplos prácticos para que puedas familiarizarte con el flujo de trabajo de Git y GitHub.
- Introducción a Git y GitHub
- Configuración inicial
- Estados de un archivo
- Conceptos básicos de Git
- Trabajando con GitHub
Git es un sistema de control de versiones distribuido que permite realizar un seguimiento de los cambios realizados en archivos y coordinar el trabajo en equipo. Proporciona una forma eficiente de manejar proyectos, realizar seguimiento de modificaciones, revertir cambios y colaborar con otros desarrolladores.
"Guardar archivos binarios en el repositorio de git es una mala práctica"
GitHub es una plataforma basada en la web que utiliza Git para alojar repositorios de código. Además de las funcionalidades de Git, GitHub ofrece características adicionales, como la posibilidad de colaborar en proyectos de código abierto, realizar seguimiento de problemas y solicitar fusiones de código.
Antes de comenzar a utilizar Git y GitHub, es necesario realizar una configuración inicial. A continuación, se detallan los pasos básicos:
Descarga Git desde https://git-scm.com/downloads e instálalo en tu sistema operativo.
Descargar GitHub Desktop desde https://desktop.github.com e instálalo en tu sistema operativo.
-
Desde Consola:
Abre una terminal o línea de comandos y ejecuta los siguientes comandos para configurar tu nombre de usuario y dirección de correo electrónico:
$ git config --global user.name "Tu Nombre" $ git config --global user.email "tu@email.com"
-
Desde GitHub Desktop:
Seleccione el menu de opciones en su apartado Git para configurar tu nombre de usuario y dirección de correo electrónico:
- Untracked: Archivo que no está siendo rastreado por Git.
- Modified: Archivo que ha sido modificado desde el último commit.
- Staged: Archivo que ha sido modificado y añadido al área de preparación.
- Committed: Archivo que ha sido modificado, añadido al área de preparación y confirmado en el repositorio.
- Pushed: Archivo que ha sido modificado, añadido al área de preparación, confirmado en el repositorio y enviado al repositorio remoto.
En esta sección, aprenderemos los conceptos básicos de Git y cómo utilizarlos.
Para comenzar a utilizar Git en un proyecto existente o en uno nuevo, debemos inicializar un repositorio.
-
Desde Consola:
Ejecuta el siguiente comando en la terminal en la ubicación de tu proyecto:
$ git init
-
Desde GitHub Desktop:
Deberas de elegir la opción de "Crear un nuevo repositorio en tu disco duro..." donde deberas llenar todos los campos correspondientes:
Un commit es una confirmación de cambios en el repositorio. Para realizar un commit, debemos seguir estos pasos:
No puedes usar commit si antes no has añadido los archivos con add.
-
Desde Consola:
- Agrega los archivos modificados al área de preparación:
$ git add nombre_archivo
- Realiza el commit con un mensaje descriptivo:
$ git commit -m "Mensaje descriptivo del commit"
-
Desde GitHub Desktop:
- Selecciona los archivos modificados:
- Realiza el commit con un mensaje descriptivo y opcionalmente agregale una descripción:
Las ramas te permiten realizar cambios sin afectar la rama principal (Main). Un ejemplo de esto es al encontrar bugs en alguna versión entras a Hotfix, entonces se crea una nueva rama donde realias los cambios y los pruebas con la versión actual del Main.
-
En Consola:
Si deseas crear una rama, ejecuta el siguiente comando:
$ git branch nombre_rama
-
En GitHub Desktop:
Deberas de elegir la opción "New Branch" dentro del dropdown de "Current Branch" llenando el campo requerido de nombre:
El comando checkout se utiliza para cambiar entre ramas existentes.
-
En Consola:
Si deseas cambiar a una rama específica, ejecuta el siguiente comando:
$ git checkout nombre_rama
-
En GitHub Desktop:
Deberas de seleccionar el dropdown de "Current Branch" para ver el listado de ramas de tu proyecto. Luego, darle click a la rama que quieres cambiar y elegir la opción de tu preferencia:
La funcionalidad de fusionar ramas permite combinar los cambios de una rama con otra.
-
En Consola:
Utiliza el siguiente comando para fusionar una rama en la rama actual:
$ git merge nombre_rama
-
En GitHub Desktop:
Deberas de seleccionar el dropdown de "Current Branch" para ver el listado de ramas de tu proyecto. Luego, darle click a "Choose a branch to merge into rama" para luego crear un merge commit:
En esta sección, aprenderemos cómo utilizar GitHub para colaborar en proyectos y aprovechar sus características adicionales.
- Inicia sesión en tu cuenta de GitHub.
- Haz clic en el botón "New" para crear un nuevo repositorio.
- Completa los detalles del repositorio, como nombre, descripción y configuración adicional.
- Haz clic en "Create repository" para crear el repositorio.
Para conectar tu repositorio local con el repositorio remoto en GitHub, utiliza el siguiente comando:
$ git remote add nombre_remoto url_remoto
El hecho de crear un repositorio se facilita desde la aplicación de GitHub Desktop. Pues, solamente es seleccionar la opción de "Publish Repository" y llenar los campos necesarios:
Una vez que hayas realizado los commits locales, puedes enviar tus cambios al repositorio remoto en GitHub.
-
Desde Consola:
Se utiliza el comando push:
$ git push nombre_remoto nombre_rama
-
Desde GitHub Desktop:
Se selecciona la opción de "Push Origin" desde la ventana principal:
Si otros colaboradores han realizado cambios en el repositorio remoto, puedes obtener esos cambios y fusionarlos con tu rama local.
-
Desde Consola:
Se utiliza el comando pull:
$ git pull nombre_remoto nombre_rama
-
Desde GitHub Desktop:
Se selecciona la opción de "Pull Origin" desde la ventana principal:
Si deseas contribuir a un proyecto en GitHub, puedes enviar una solicitud de fusión de código (pull request) para que los propietarios del repositorio revisen tus cambios y los incorporen al proyecto principal. Debes hacerlo desde GitHub
Para crear un pull request hay que dar clic en “Compare & pull request”
Una vez creado, el administrador del proyecto recibirá una notificación.
¡Felicidades! Ahora tienes una base sólida para comenzar a utilizar Git y GitHub. Este documento solo proporciona una introducción básica, pero te animamos a explorar más a fondo cada uno de los temas mencionados y a utilizar las numerosas características adicionales que ofrecen estas herramientas.