Tutorial da ferramenta de Versionamento Git

O git se tornou uma ferramenta essencial na vida de grande parte de desenvolvedores que trabalham em projetos em equipe atualmente, se tornando a mais popular no quesito e sendo usado pelas maiores empresas no mercado hoje em dia, por sua modernidade, facilidade e código aberto. Criado por Linus Torvaldos (Conhecido pelo desenvolvimento do Kernel do GNU/Linux), o Git é um Sistema de Controle de Versão que ajuda no controle de fluxo de projetos, gerando para ele historicos de alterações, tratamento de conflito na alteração de um mesmo arquivo, ramificações (branchs) que ajudam no controle de testes e features isolando de algo que já esteja funcionando e a possibilidade de manter o código guardado em repositórios como GitHub, GitLab ou Azure Devops, sem a necessidade de trocar os comandos para utilizar.

O Tutorial

Nesse tutorial quero te mostrar a usar principalmente a linha de comando, mesmo que editores de código como Visual Studio Code possuam ferramentas e extensões para utilizar de uma maneira mais visual, o terminal ainda tem grandes vantagens e ainda lhe dará a maior parte das opções possiveis.

Para isso é preciso instalar o git, no caso do GNU/Linux ele pode ser instalado pelos gerenciadores de pacote como yum para sistemas baseados em Red Hat ou apt para baseados em Debian com o seguinte comando

sudo apt install git-all #ou
sudo yum install git-all

No caso do MacOSX, se você tiver o brew você pode instalar facilmente com

brew install git

Para Windows é necessario baixar o Git Bash para melhor usabilidade

Para mais informações acesse o seguinte website: Instalando o Git

Inicializando um projeto com o git

Para inicializar um projeto localmente com o git é possivel com o seguinte comando dentro do diretório do projeto:

git init

A partir disso qualquer alteração dentro do projeto poderá ser registrada e controlada.

Como alterações funcionam

Quando você inicializa o git em um projeto com git init a ferramenta cria para você uma branch (geramente chamada master) e um arquivo chamado .git que apenas é visivel caso digite ls -a em algum terminal bash (ou para windows o git bash), não remova a pasta .git pois ela guarda o registro de alterações.

O git trabalha com um sistema chamado commit. Um commit é o ato de tornar permanente uma ou um conjunto de alterações feitas podendo ser até mesmo etiquetadas por mensagens como "adiçaõ do arquivo arquivo.txt", ou seja, caso você adicione um arquivo naquele diretorio o git inicialmente não irá reconhecer e nem gravar o historico de alterações.

No exemplo acima fazemos os seguintes passos: criamos um diretório, inicializamos o git dentro dele, criamos um arquivo simples e, com o comando git status, checamos o historico de alterações. É mostrado que o arquivo que adicionamos não é possivel de ser registrada pelo historico e para isso precisamos adiciona-la.

Vamos usar o seguinte comando:

git add <arquivo> #caso queira adicionar um conjunto de arquivos, vá a raiz do projeto e digite: git add .
git commit #caso queira adicionar um comentario da alteração pode com: git commit -m "<comentario>"

Vemos que agora o git não reclama mais do arquivo e podemos seguir em frente. Vamos supor que aquele arquivo é um arquivo que nós nao queremos que o git tenha mais conhecimento dele para remover depois, para fazer isso use:

git rm --cached <arquivo>

Mostrando o Histórico

Você no momento fez vários commits e adições no seu projeto e agora você quer ver o historico dessas alterações:

git log

Ele irá te mostrar todas as alterações já feitas naquele projeto junto com um id para cada commit. Caso você queira apenas ver as ultimas 10 alterações do projeto pode usar:

git log -n 10

Mas como saber o que aquele commit especifico fez no meu projeto? use o git show:

git show <parte_do_id>

Ramificações (ou branchs)

O git possui um sistema muito bom chamado branches, que no caso são ramificações que podem isolar o desenvolvimento do projeto, sendo possivel criar varias ramificações para por exemplo produção, desenvolvimento, uma nova feature. Como foi mostrado usando o Git Bash para windows, a branch que estamos utilizando aparece logo acima entre parênteses, mas em alguns shells mais antigos como sh ou bash não possuem essa opção, para verificar a branch atual use:

git branch

que ele irá mostrar com um * a branch atual sendo utilizada. Para criar uma nova branch use:

git checkout -b <nome_branch>

Ele irá criar e automaticamente mudar para a nova ramificação. se quiser voltar apenas use git checkout <nome_branch> para voltar para a existente.

Repositórios

Até agora o que eu mostrei foram apenas modificações locais mas geralmente git é necessário quando temos uma equipe trabalhando e fazendo commits para um local que podemos facilmente acessar e fazer nossos commits tambem. para isso temos o repositório de código, como o proprio GitHub por exemplo, onde podemos mandar nossas alterações e obter a ultima versão do historico de alterações.

Vamos primeiro criar um novo repositório, que pode ser feito com a ajuda desse Tutorial.

Agora existe algumas maneiras de como podemos adicionar de como podemos linkar nosso repositorio com nosso projeto atual, nesse tutorial irei mostrar duas das maneiras que vi que são mais utilizadas.

• Clonar o projeto, mover os arquivos nos quais estava trabalhando para o clone, adicionar eles ao repositório e mandar as alterações para o repositório

git clone <url_do_repositório> #se quiser adicionar um nome diferente á pasta criada use: git clone <url_do_repositório> <nome_pasta>
cd <nome_repositório>
mv ../caminho/do/projeto/* .
git add .
git commit -m "<comentario>"
git push origin <branch_remota>

Vimos comandos novos até o momento, vamos explicar cada um:
git clone <url_do_repositório>: ele faz um clone de tudo o que está no repositório remoto para dentro de uma pasta do seu computador.
git push origin <branch>: esse comando manda todos os commits que não estão no repositório para ele, agora sendo visivel por todo o time. origin nesse caso é o nome que o repositório dá para o clone do projeto para ter uma maneira de identificar para onde que os commits devem ir.

• Dentro do projeto adicionar um link remoto, pegar todas as alterações do repositório remoto, e mandar as alterações. dentro do projeto git digite:

git remote add <nome_remoto> <url_do_repositório>
git pull <nome_remoto> <branch_remota>
git push <nome_remoto> <branch_remota>

Ainda não expliquei o comando git pull:
git pull: pega todas as alterações do repositório

é possivel que de um erro com a mensagem dizendo que o git se recusa a fazer o merge de históricos não relacionados, o que é possivel de se resolver com o comando:

git pull <nome_remoto> <branch_remota> --allow-unrelated-histories

Removendo alterações locais:

Caso você tenha feito um commit e não queira que ele seja adicionado no histórico quando for mandado para o repositório, você pode remover aquele commit com o seguinte comando:

git reset --soft HEAD~1

Para checar todos os commits que nao foram mandados para o repositório, use:

git cherry

Resolvendo conflitos

Vimos até agora que o git é uma ferramenta poderosa para a utilização de versionamento para equipes de desenvolvimento. mas o que acontece quando ocorre a alteração de um mesmo arquivo em uma mesma linha por um outro desenvolvedor e logo depois fazemos o git pull? os famosos conflitos. um bom exemplo disso pode ser explicado com o seguinte video. No video o João usa um editor de código chamado Visual Studio Code para resolver as alterações, porem o proprio git ja vem com um "editor de conflitos" chamado mergetool onde é possivel utilizar ferramentas de linha de comando ou gráficas para se corrigir tais problemas.

Primeiro para checar as diferenças no conflito podemos utilizar o seguinte comando:

git diff

Para resolver o conflito use o comando:

git mergetool 

Caso prefira uma ferramenta visual, ou utilize o Visual Studio Code por exemplo, ou use o p4merge que no caso precisa ser baixado e é suportado como uma ferramenta oficial para merge.

Para utilizar:

git mergetool --tool=<nome_ferramenta_de_merge>

Muito Obrigado

Muito obrigado para você que leu até aqui, caso tenha alguma recomendação ou mudança que eu deva fazer me contate via as Issues do GitHub!!