leobusar / test

test

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Guía de Aprendizaje de Git y GitHub

¡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.

Tabla de Contenido 📁

  1. Introducción a Git y GitHub
    1. ¿Qué es Git?
    2. ¿Qué es GitHub?
  2. Configuración inicial
    1. Instalación de Git
    2. Instalación de GitHub Desktop
    3. Configuración de Git
  3. Estados de un archivo
  4. Conceptos básicos de Git
    1. Inicializar un repositorio
    2. Realizar un commit
    3. Crear una rama (branch)
    4. Cambiar de rama (checkout)
    5. Fusionar ramas (merge)
  5. Trabajando con GitHub
    1. Crear un repositorio en GitHub
    2. Conectar repositorio local con repositorio remoto
    3. Publicar un repositorio desde GitHub Desktop
    4. Enviar cambios a GitHub (push)
    5. Obtener cambios del repositorio remoto (pull)
    6. Solicitar una fusión de código (pull request)

Introducción a Git y GitHub 💻️

¿Qué es Git?

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"

¿Qué es GitHub?

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.

Configuración inicial ⚙️

Antes de comenzar a utilizar Git y GitHub, es necesario realizar una configuración inicial. A continuación, se detallan los pasos básicos:

Instalación de Git

Descarga Git desde https://git-scm.com/downloads e instálalo en tu sistema operativo.

Linux MacOS Windows

Instalación de GitHub Desktop

Descargar GitHub Desktop desde https://desktop.github.com e instálalo en tu sistema operativo.

MacOS Windows

Configuración de Git

  • 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:

    Configuracion

Estados de un Archivo 📂️

  • 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.
file-status

Conceptos básicos de Git 📝

En esta sección, aprenderemos los conceptos básicos de Git y cómo utilizarlos.

Inicializar un repositorio

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:

    Repositorio

Realizar un commit

Un commit es una confirmación de cambios en el repositorio. Para realizar un commit, debemos seguir estos pasos:

GitFlow

No puedes usar commit si antes no has añadido los archivos con add.

  • Desde Consola:

    1. Agrega los archivos modificados al área de preparación:
    $ git add nombre_archivo
    1. Realiza el commit con un mensaje descriptivo:
    $ git commit -m "Mensaje descriptivo del commit"
  • Desde GitHub Desktop:

    1. Selecciona los archivos modificados:
    Add
    1. Realiza el commit con un mensaje descriptivo y opcionalmente agregale una descripción:
    Commit

Crear una rama (branch)

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:

    Branch

Cambiar de rama (checkout)

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:

    Branch Branch

Fusionar ramas (merge)

La funcionalidad de fusionar ramas permite combinar los cambios de una rama con otra.

Merge
  • 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:

    Branch

Trabajando con GitHub 🤝

En esta sección, aprenderemos cómo utilizar GitHub para colaborar en proyectos y aprovechar sus características adicionales.

Crear un repositorio en GitHub

  1. Inicia sesión en tu cuenta de GitHub.
  2. Haz clic en el botón "New" para crear un nuevo repositorio.
  3. Completa los detalles del repositorio, como nombre, descripción y configuración adicional.
  4. Haz clic en "Create repository" para crear el repositorio.

Conectar repositorio local con repositorio remoto

Para conectar tu repositorio local con el repositorio remoto en GitHub, utiliza el siguiente comando:

$ git remote add nombre_remoto url_remoto

Publicar un repositorio desde GitHub Desktop

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:

publish-main publish

Enviar cambios a GitHub (push)

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:

    push

Obtener cambios del repositorio remoto (pull)

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:

    pull

Solicitar una fusión de código (pull request)

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

pull-request

Para crear un pull request hay que dar clic en “Compare & pull request”

pull-request-github

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.

Happy coding! 🚀

forthebadge forthebadge

About

test