Sumário
1. Iniciando o git
2. Trabalhando com Repositório remoto
3. Adicionando arquivos para área de preparação
4. Área de preparação
5. Criando branches
7. Atualizando repositórios
8. Contribuindo com repositórios de terceiros
1. Iniciando o git
git init
Rodando esse comando na sua pasta será criado um novo repositório local.
Caso essa pasta ja seja um repositório, esse será reiniciado.
2. Trabalhando com Repositório remoto
Repositório remoto consite em um repositorio com serviço de nuvem, o qual o codigo fica armazenado além do repositório local
Exemplos de serviços de nuvem: Github, Gitlab, Bitbucket
2.1 Relacionando repositório local com remoto
git remote add <nome_do_remote> https://github.com/Username/Nome_do_repositório.git
OBS: nome do remote normalmente usado: origin
3. Adicionando/Removendo arquivos da área de preparação
3.1 Adicionando:
git add
Antes de ficar disponível para um commit, os arquivos e/ou pastas do seu repositório precisam ser adicionados ao Git index, ou área de preparação.
O Git index contém as últimas alterações da sua árvore de trabalho antes do próximo commit.
3.1.1 Uso:
Para todas as alterações:
git add .
Para um arquivo específico:
git add <nome_do_arquivo>
Para uma pasta específica:
git add <nome_da_pasta>
3.2 Removendo:
git reset HEAD
O comando reset retorna a zona do buffer para HEAD. Isso limpa a zona do buffer das mudanças que nós acabamos de adicionar ao Git index, ou área de preparação.
3.2.1 Uso:
Para todos os arquivos da área de preparação:
git reset HEAD *
Para um arquivo específico:
git reset HEAD <nome_do_arquivo>
Para uma pasta específica:
git reset HEAD <nome_da_pasta>
4. Commits
git commit -m 'mensagem do commit'
4.1 Área de stage
Área onde adicionamos quais modificações serão versionadas pelo git no próximo commit. Para adicionar arquivos na stage area utilizamos o comando git add. Podemos adicionar arquivos específicos ou todos os arquivos modificados:
Para arquivos especificos: git add <filename>
Para todos os arquivos: git add .
4.2 Commit
"Salva" as modificações nos arquivos (desde que estejam na área de stage) e adiciona mais um ponto na linha do tempo do projeto. Para realizar um commit, utiliza-se o seguinte comando.
git commit -m '<mensagem do commit>'
4.3 Atalho
Com o comando abaixo, irá adicionar todos os arquivos modificados na área de stage e também realizar o commit com a mensagem escolhida:
git commit -am 'mensagem do commit'
4.4 Histórico de commits
O comando abaixo irá listar os commits feitos no repositório em ordem cronológica inversa. Além disso, esse comando listará cada commit com o seu checksum SHA-1, o nome e email do autor, data de inserção, e a mensagem do commit.
git log
5. Criando branches
Esse master é um branch que o git cria automagicamente quando você faz um commit sem estar em nenhum branch (como é o caso de um repositório recém criado).
OBS: No github, por default, todo novo repo terá a branch nomeada como main, substituindo o branch master.
Quando usamos Git, quase todas as operações são feitas dentro de um branch. Um branch nada mais é que uma lista de commits. Você pode criar, apagar e renomear branches.
Para listar as branches presentes no repositório você usa git branch. Para criar você usa o comando git branch NOME_DO_BRANCH. Para apagar git branch -D NOME_DO_BRANCH. Para renomear você usa git branch -m NOME_ANTIGO NOME_NOVO. E para mudar de branch você usa git checkout NOME_DO_BRANCH.
Exemplo:
git branchlista as branchesgit branch workcria o branch workgit branch -D workapaga o branch workgit branch -m work asdrubalrenomeia o branch work para asdrubalgit checkout workmuda para a branch work
5.1 Unindo branches
Para combinar as mudanças feitas de uma branch para outra branch usamos o comando git merge <nome_da_branch>.
Exemplo: Unindo as mudanças feitas na branch new_feature na branch atual:
git merge new_feature
6. Clonando repositórios
Para criar uma cópia local de um repositório remoto use o comando:
git clone <remote_URL>
Exemplo:
Criando um repositório local como cópia do repositório remoto climate-app:
git clone https://github.com/joaovictornsv/climate-app.git
7. Atualizando repositórios
7.1 Repositório local (git pull)
Para atualizar seu repositório local com as últimas alterações feitas no repositório remoto use o comando:
git pull <remote_URL ou remote_name> <nome_da_branch>
Exemplo:
Atualizando branch atual com a branch remota feature>
git pull origin feature
7.1 Repositório remoto (git push)
Para atualizar seu repositório remoto com as últimas alterações feitas no repositório local use o comando:
git push <remote_URL ou remote_name> <nome_da_branch>
Exemplo:
Atualizando branch remota master com a branch atual
git push origin master
8. Contribuindo com repositórios de terceiros
Um grande diferencial de plataformas open-source é a possibilidade de contribuir com repositórios de terceiros, para isso é preciso seguir os seguintes passos:
1 - Vá até o repositório que deseja contribuir https://github.com/Username/Nome_do_repositório
2 - Fork o repositório, com isso você criará uma ramificação do repositório principal, a qual poderá fazer mudanças,
pois essa será a SUA versão do projeto principal
3 - Clone seu repositório "forkado" do projeto principal com:
git clone https://github.com/Seu_Username/Nome_do_repositório.git
4 - Crie uma nova Branch:
cd repositório
git branch nome_da_nova_branch
5 - Mude para a nova branch: git checkout nome_da_nova_branch
6 - Faça alterações no seu repositório "forkado" e use o comando push
já que esta ultilizando uma nova branch, use o comando git push --set-upstream origin nome_da_nova_branch
7 - No github clique em "Compare e Pull Request" para enviar para o usuário do repositório as mudanças feitas comparadas com o repositório principal, com isso ele irá analisar as alterações e decidir aceitar ou não suas mudanças, com um Merge(adicionar suas mudanças ao codigo principal)
obs: importante deixar um comentário no pull request, explicando oque foi alterado no código