DEV Community

Cover image for Intro Git and github 馃捇
Lara D铆az
Lara D铆az

Posted on

Intro Git and github 馃捇

驴Qu茅 es git y github?
Enter fullscreen mode Exit fullscreen mode

Git es un sistema de control de versiones distribuido que utilizan los desarrolladores de software que contribuyen a un mismo proyecto o software. B谩sicamente ayuda a los usuarios a rastrear los diferentes cambios realizados en el software por diferentes usuarios.

Github es una plataforma que proporciona alojamiento y control de versiones para su c贸digo y cualquiera puede colaborar en cualquier proyecto en todo el mundo.

C贸mo empezar a usar Github
Enter fullscreen mode Exit fullscreen mode

Lo primero que tenemos que hacer es configurar el entorno, por lo que necesitamos descargar git. Para cualquier sistema operativo podemos descargarlo aqui

git page

Alt Text

Una vez que hayamos instalado correctamente git, podemos abrir la terminal y escribir el siguiente comando para comprobarlo.

Alt Text

Despu茅s de esto podemos ir al sitio web de Github y crear una cuenta si no tenemos.

La cuenta se ver谩 similar a algo como esto:

Alt Text


Configurar git con nombre de usuario y correo electr贸nico.
Enter fullscreen mode Exit fullscreen mode

Ahora que tenemos Git en el sistema, queremos personalizar el entorno de Git. S贸lo es necesario hacer estas cosas una vez; se mantendr谩n entre actualizaciones. Tambi茅n podemos cambiarlas en cualquier momento volviendo a ejecutar los comandos correspondientes.

Lo primero que debemos hacer cuando instalamos Git es establecer nuestro nombre de usuario y direcci贸n de correo electr贸nico. Esto es importante porque las confirmaciones de cambios (commits) en Git usan esta informaci贸n, y es introducida en cada commit que hagamos:

Abrir un terminal/shell:

Alt Text

Si queremos comprobar la configuraci贸n, podemos usar el comando git config --list para listar todas las propiedades que Git ha configurado:

Alt Text

Listo! Ya tenes github configurado!

Alt Text


Hay ciertos pasos que debemos seguir para empezar a contribuir en tu trabajo, proyectos propios u Open Source:

  1. Creaci贸n de un repositorio.
  2. Fork de un repositorio.
  3. Clone de un repositorio.
  4. Creando commits.
  5. Push c贸digo.
  6. Creando una rama(branch).
  7. Creando issues.
  8. Crear un pull request.
  9. Actualizando el contenido del repo.
Creaci贸n de un repositorio.
Enter fullscreen mode Exit fullscreen mode

Un repositorio es una carpeta 煤nica que contiene los archivos necesarios para el proyecto, podemos decir que es un nombre alternativo para directorio. Para crear un repositorio podemos ver la esquina superior derecha de tu ventana donde tenemos una opci贸n para crear repositorio como se muestra en la imagen de abajo:

Alt Text

Una vez que hayamos hecho click, tendremos que ingresar informaci贸n sobre el repositorio, como su nombre, si queremos incluir el archivo Readme (archivo de nuestro repositorio en donde podr铆amos contarle a la comunidad de GitHub de que trata nuestro proyecto.), o incluir alg煤n archivo, etc.

Alt Text

Otra forma de hacerlo es con Git Init

Este comando se usa para crear un nuevo repositorio en Git. Nos crea un repositorio de manera local y lo har谩 en la carpeta donde estamos posicionados o se le puede pasar [nombre_de_la_carpeta] y crear谩 la carpeta con ese nombre.

Alt Text

Fork de un repositorio.
Enter fullscreen mode Exit fullscreen mode

Un fork es un clon del repo en github y que funciona como un branch del original y es la forma principal por la cual alguien puede proponer cambios a un repositorio que no creo.

Si queremos contribuir en alg煤n proyecto de otra persona, el primer paso es hacer un fork del proyecto para crear una copia de los archivos de ese proyecto en nuestra cuenta de github.

Alt Text

Clone de un repositorio.
Enter fullscreen mode Exit fullscreen mode

Para poder trabajar y modificar un proyecto, el primer paso es descargar los archivos en su PC para ejecutarlos. Este proceso se conoce como clonaci贸n de un repo. Debemos abrir la terminal, posicionarnos en la carpeta donde queremos descargar los archivos (Ej: desktop) y ejecutar el siguiente comando:

Alt Text

Hecho esto, tendremos una copia del proyecto en nuestra PC.

Creando commits.
Enter fullscreen mode Exit fullscreen mode

El comando "commit" guardar谩 todos los cambio hechos en la zona de montaje o 谩rea de preparaci贸n (staging area), junto con una breve descripci贸n del usuario, en un "commit" al repositorio local.

Para agregar el o los archivos al Staging Area vamos a usar el comando add:

Alt Text

Ahora en verde nos indica que tenemos un archivo o mas listos para hacer un commit en nuestro repositorio, hasta que no hagamos un commit nuestros archivos permanecer谩n en 鈥渆l limbo鈥 en el estado Ready justo antes de enviar nuestro archivo a nuestros repositorio.

Alt Text

Push c贸digo.
Enter fullscreen mode Exit fullscreen mode

Nuestro repositorio local ya tiene nuestros cambios, ahora si queremos enviarlos a nuestro repositorio remoto (ya sea un fork, clone o propio), vamos a usar un comando llamado git push, vamos a empujar nuevos cambios. Podemos hacerlo con el siguiente comando:

Alt Text

Creando una rama(branch).
Enter fullscreen mode Exit fullscreen mode

Como sabemos, cada vez que desarrollamos cualquier software o proyecto, a menudo creamos nuevas features o corregimos un error(fix), por lo que utilizamos ramas para ello.
Las ramas son caminos que puede tomar cualquier desarrollador dentro del proyecto, que agrupan commits y que pueden volver a unirse al camino principal de la aplicaci贸n.
Es b谩sicamente una manera de mantener la diferencia en el c贸digo original con respecto a la nueva features o fix.

Para comprobar la rama existente en el proyecto podemos escribir el siguiente comando:

Alt Text

Para crear una nueva rama podemos ejecutar el siguiente comando en el terminal:

Alt Text

Para comprobar o cambiar la rama actual puede utilizar el siguiente comando:

Alt Text

Es una buena pr谩ctica crear una nueva rama para cada issue creado.


Creando issues.
Enter fullscreen mode Exit fullscreen mode

En la solapa "Issues鈥 los diferentes colaboradores del proyecto pueden remarcar y alertar acerca de diferentes 鈥渂ugs鈥 o 鈥減roblemas鈥 dentro del proyecto.
Si queremos trabajar en alguna issue podemos comentar en ese mismo que estamos interesados en trabajar. El administrador del proyecto o los maintainers nos asignar谩n el issue, y entonces podremos empezar a trabajar en 茅l.

Alt Text

En el caso del Open Source, suele haber una guia para contribuidores que explica el formato preferido de Issues, pull request y commits.

Crear un pull request.
Enter fullscreen mode Exit fullscreen mode

Para que los colaboradores revisen los cambios que hemos hecho y los aprueben en el repositorio original, necesitamos crear una solicitud de revisi贸n o pull request.

Alt Text

Actualizando el contenido del repo.
Enter fullscreen mode Exit fullscreen mode

Al ser git un sistema donde m煤ltiples personas colaboran, puede ser que necesitemos mantener nuestro repositorio local actualizado.
Para ello hay dos maneras en que podemos hacerlo:

  1. Usando git pull.
  2. Usando rebase.

En la opci贸n 1, usamos el siguiente comando:

Alt Text

aqu铆 upstream es la ubicaci贸n desde la que necesitamos actualizar el contenido y main es la rama de la que hay que hacer pull.

Para la opci贸n 2, podemos utilizar el siguiente comando:

Alt Text

Rebase es preferible en comparaci贸n con pull, ya que pull es una combinaci贸n de git fetch y git merge que fusiona los cambios locales con las actualizaciones.


Compart铆 tu opini贸n o escribime!
Github
Twitter

Discussion (0)