Forem: David Rojo

[EN] Git. Guide from scratch

David Rojo — Mon, 07 Nov 2022 17:14:19 +0000

In this article we will cover everything from creating a new repository to publishing it on a server and some commands that I use on a daily basis that may be useful.

Installed Git is a must.

1. ¿What is Git?

Git is the most widely used version control system in use nowadays, it has become the de facto standard for most companies, so it is important to know how to manage it efficiently.

A versioned project in Git is composed of a minimum of four areas:

Working Area: contains files that have been created, modified or deleted.
Stash Area: files that have been modified and we've set aside to do something with them in the future.
Staging Area: contains the files that we want to be added to the repository.
Local Repository: This is the modification history of our repository, it is made up of different branches that contain all the changes that have been made to a project.

The branches are copies of the project starting from the same codebase, their function is to implement changes to our repository.

Additionally, we can have one more area, called Remote repository, which is nothing more than a copy of our Local Repository area, located in one or more servers, be it GitHub, GitLab or BitBucket among others...

It is possible to have more than one Remote Repository for a single Local Repository.

2. Initial configuration.

The first thing we have to do after installing Git is to configure our credentials, for this we are going to make use of these three commands.

$ git config --global user.name "your_username" 
$ git config --global user.email "your_email" 
$ git config --global core.editor "your_text_editor"

Vim is the default text editor.

3. Initialising/Downloading a repository.

To start a repository we just need to run the git init command inside our project directory.

To download (clone) an existing repository, we must execute the command git clone <url_repository>.

Common commands.

Most of the commands contain extra parameters that for simplicity will not be explained in this article. The most common ones for everyday use will be explained.

4.1. Files.

git add <file>: allows us to move files from Working directory to Staging Area.
git stash: allows us to reserve changes from our Staging Area for later use.
git stash list : allows us to list the changes we have previously stashed.
git stash pop : allows us to retrieve the last change we saved.
git stash pop <index_stash>: retrieve the change with a given index .
git stash drop : allows us to delete a change we have reserved.
git commit -m "message": allows us to move files from Staging Area to Local Repository by adding a message.
git diff <filename>:shows the difference in a file from its previous version.
git reset: allows us to move all files from Staging Area to Working Directory.
git reset <filename>: allows us to move a file from the Staging Area to the Working Directory.
git reset --soft HEAD~<commits_number>: allows us to undo changes to our Local Repository x commits backwards without losing those modifications, where x=<commits_number>.
git restore <filename>: allows us to undo changes that have been made to a file.

4.2. Branches.

git branch: lists all the branches in our Local Repository and which one we are currently on.
git branch -d: remove a branch that has already been merged into another branch.
git branch -D:forces the removal of a branch, whether it has already been merged or not.
git switch <destination_branch_name>: allows us to switch to the destination branch.
git switch -c <branch_name>: create a new branch from the branch we are currently on and move to it.
git checkout <id_commit>: allows us to move to an existing commit.
git merge <branch_to_merge>: merge a branch into our current branch.

4.3. Remote Repository.

git remote add <link_name> <url_repository>: links our Local Repository to a Remote Repository.
git remote remove <link_name>: delete a link to a Remote Repository.
git remote -v: lists which Remote Repositories our Local Repository is linked to.
git push <link_name> <remote_branch>: allows us to upload commits from our Local Repository to a Remote
Repository.
git push -f <link_name> <remote_branch>: allows us to force the upload of commits from our Local Repository to a Remote Repository.
git fetch: download metadata from a Remote Repository to a Local Repository.
git pull: is a combination of git fetch and git merge, it pulls the changes and metadata from a Remote Repository and merges them with our current branch in Local Repository.

4.4. Generic.

git status: shows the current status of our repository.
git log: lists the changes.

If you know of a useful command that you think should be on this list, don't hesitate to comment!

[ES] Git. Guía desde cero.

David Rojo — Sun, 06 Nov 2022 23:45:00 +0000

En este artículo veremos desde la creación de un nuevo repositorio hasta la publicación de este en un servidor y comandos que uso a diario que pueden resultar útiles.

Será necesario tener Git instalado en nuestro equipo.

1. ¿Qué es Git?

Git es el sistema de control de versiones más usado actualmente, se ha convertido en el estándar de facto para la mayoría de las empresas, por eso es importante saber cómo manejarlo eficientemente.

Un proyecto versionado en Git, está compuesto por un mínimo de cuatro áreas:

Working Area: comprende los ficheros que han sido creados, modificados o borrados.
Stash: comprende los ficheros que han sido modificados y hemos reservado para hacer algo con ellos en un futuro.
Staging Area: comprende los ficheros que queremos que sean añadidos al repositorio.
Local Repository: Es el historico de modificaciones de nuesto repositorio, esta compuesto por diferentes ramas que contienen todos los cambios que se han realizado sobre un proyecto.

Las ramas son copias del proyecto que parten de la misma base de código, utilizadas para implementar cambios a nuestro repositorio.

Adicionalmente, podemos tener un área más, llamada Remote repository, que no es más que una copia de nuestra área Local Repository, localizada en uno o varios servidores, ya sean GitHub, GitLab o BitBucket entre otros...

Es posible tener más de un Remote Repository para un Local Repository.

2. Configuración inicial.

Lo primero que tenemos que hacer tras instalar Git es configurar nuestras credenciales, para esto vamos a hacer uso de estos tres comandos.

$ git config --global user.name "tu_nombre_de_usuario"
$ git config --global user.email "tu_email"
$ git config --global core.editor "tu_editor_de_texto"

El editor de texto por defecto es Vim.

3. Iniciar/Descargar un repositorio.

Para iniciar un repositorio solo tenemos que ejecutar el comando git init dentro del directorio de nuestro proyecto.

Para descargar(clonar) un repositorio ya existente, debemos ejecutar el comando git clone <url_repositorio>.

4. Comandos comunes.

La mayoría de los comandos contienen parámetros extra que por simplicidad no serán explicados en este artículo. Serán explicados los más comunes para un uso cotidiano.

4.1. Ficheros.

git add <fichero>: nos permite mover ficheros desde Working directory a Staging Area.
git stash: nos permite reservar los cambios de nuestro Staging Área para ser usados posteriormente.
git stash list : nos permite listar los cambios que hemos reservado con anterioridad.
git stash pop: nos permite recuperar el último cambio que hemos guardado.
git stash pop <índice_stash>: nos permite recuperar el cambio con índice <índice_stash>.
git stash drop : nos permite borrar un cambio que hemos reservado.
git commit -m "mensaje": nos permite mover ficheros desde Staging Area a Local Repository añadiendo un mensaje.
git diff <nombre_fichero>:muestra la diferencia sobre un fichero con respecto a su anterior versión.
git reset: nos permite mover todos los ficheros desde Staging Area a Working Directory.
git reset <nombre_fichero>: nos permite mover un fichero desde Staging Area a Working Directory.
git reset --soft HEAD~<numero_de_commits>: nos permite deshacer los cambios de nuestro Local Repository x commits hacia atrás sin perder esas modificaciones, donde x=<numero_de_commits>.
git restore <nombre_fichero>: nos permite deshacer los cambios que se han realizado sobre un fichero.

4.2. Ramas.

git branch: lista todas las ramas de nuestro Local Repository y en cuál estamos actualmente.
git branch -d: elimina una rama que ya ha sido fusionada con otra.
git branch -D:fuerza la eliminación de una rama, haya sido ya fusionada o no.
git switch <nombre_rama_destino>: nos permite cambiarnos a la rama destino.
git switch -c <nombre_rama>: crea una nueva rama a partir de la rama en la que nos encontramos actualmente y nos movemos a esta.
git checkout <id_commit>: nos permite movernos hacia un commit existente.
git merge <rama_a_fusionar>: fusiona una rama con nuestra rama actual.

4.3. Repositorio Remoto.

git remote add <nombre_vinculo> <url_repositorio>: vincula nuestro Local Repository con un Remote Repository.
git remote remove <nombre_vinculo>: borra un vínculo con un Remote Repository.
git remote -v:lista con que Remote Repositories está vinculado nuestro Local Repository.
git push <nombre_vínculo> <rama_remota>: nos permite subir los commits de nuestro Local Repository a un Remote
Repository.
git push -f <nombre_vínculo> <rama_remota>: nos permite forzar la subida de los commits de nuestro Local Repository a un Remote Repository.
git fetch: descarga los metadatos de un Remote Repository a un Local Repository.
git pull: es una combinación de git fetch y git merge, descarga los cambios y metadatos de un Remote Repository y los fusiona con nuestra rama actual en Local Repository.

4.4. Genéricos.

git status: muestra el estado actual de nuestro repositorio.
git log: lista los cambios que se han realizado en nuestro Local Repository.

Si conoces algún comando útil y crees que debería estar en esta lista, no dudes en comentarlo!