learnxinyminutes-docs/pt-br/git-pt.html.markdown

543 lines
16 KiB
Markdown
Raw Normal View History

---
category: tool
tool: git
lang: pt-br
2016-10-20 16:54:50 +00:00
filename: LearnGit-br.txt
contributors:
- ["Jake Prather", "http://github.com/JakeHP"]
- ["Leo Rudberg" , "http://github.com/LOZORD"]
- ["Betsy Lorton" , "http://github.com/schbetsy"]
- ["Bruno Volcov", "http://github.com/volcov"]
translators:
2015-02-04 15:13:13 +00:00
- ["Suzane Sant Ana", "http://github.com/suuuzi"]
- ["Bruno Volcov", "http://github.com/volcov"]
2022-07-16 14:54:05 +00:00
- ["Marcel Ribeiro-Dantas", "http://github.com/mribeirodantas"]
---
2015-02-04 15:13:13 +00:00
Git é um sistema distribuido de gestão para código fonte e controle de versões.
2015-02-04 15:13:13 +00:00
Funciona através de uma série de registos de estado do projeto e usa esse
registo para permitir funcionalidades de versionamento e gestão de código
fonte.
2015-02-04 15:13:13 +00:00
## Conceitos de versionamento
2015-02-04 15:13:13 +00:00
### O que é controle de versão
2015-02-04 15:13:13 +00:00
Controle de versão (*source control*) é um processo de registo de alterações
a um arquivo ou conjunto de arquivos ao longo do tempo.
2015-02-04 15:13:13 +00:00
### Controle de versão: Centralizado VS Distribuído
2015-02-04 15:13:13 +00:00
* Controle de versão centralizado foca na sincronização, registo e *backup*
de arquivos.
* Controle de versão distribuído foca em compartilhar alterações. Cada
alteração é associada a um *id* único.
* Sistemas distribuídos não têm estrutura definida. É possivel ter um sistema
2015-02-04 15:13:13 +00:00
centralizado ao estilo SVN usando git.
2015-02-04 15:13:13 +00:00
[Informação adicional (EN)](http://git-scm.com/book/en/Getting-Started-About-Version-Control)
2015-02-04 15:13:13 +00:00
### Por que usar git?
2015-02-04 15:13:13 +00:00
* Permite trabalhar offline.
* Colaborar com outros é fácil!
* Criar *branches* é fácil!
* Fazer *merge* é fácil!
* Git é rápido.
* Git é flexivel.
## Git - Arquitetura
### Repositório
2015-02-04 15:13:13 +00:00
Um conjunto de arquivos, diretórios, registos históricos, *commits* e
referências. Pode ser descrito como uma estrutura de dados de código fonte
com a particularidade de cada elemento do código fonte permitir acesso ao
histórico das suas alterações, entre outras coisas.
Um repositório git é constituído pelo diretório .git e a *working tree*
### Diretório .git (componente do repositório)
2015-02-04 15:13:13 +00:00
O repositório .git contém todas as configurações, *logs*, *branches*,
referências e outros.
[Lista detalhada (EN)](http://gitready.com/advanced/2009/03/23/whats-inside-your-git-directory.html)
2015-02-04 15:13:13 +00:00
### *Working Tree* (componente do repositório)
2015-02-04 15:13:13 +00:00
A *Working Tree* é basicamente a listagem dos diretórios e arquivos do repositório. É chamada também de diretório do projeto.
2015-02-04 15:13:13 +00:00
### *Index* (componente do diretório .git)
2015-02-04 15:13:13 +00:00
O *Index* é a camada da interface no git. É o elemento que separa
o diretório do projeto do repositório git. Isto permite aos programadores um
maior controle sobre o que é registado no repositório git.
2015-02-04 15:13:13 +00:00
### *Commit*
2015-02-04 15:13:13 +00:00
Um *commit** de git é um registo de um cojunto de alterações ou manipulações nos arquivos do projeto.
Por exemplo, ao adicionar cinco arquivos e remover outros 2, estas alterações
serão gravadas num *commit* (ou registo). Este *commit* pode então ser enviado
para outros repositórios ou não!
2015-02-04 15:13:13 +00:00
### *Branch*
2022-07-16 13:52:03 +00:00
Uma *branch* é essencialmente uma referência que aponta para o último *commit*
2015-02-04 15:13:13 +00:00
efetuado. Na medida que são feitos novos commits, esta referência é atualizada
automaticamente e passa a apontar para o commit mais recente.
### *Tag*
Uma tag é uma marcação em um ponto específico da história. Geralmente as
pessoas usam esta funcionalidade para marcar pontos de release (v2.0, e por aí vai)
2015-02-04 15:13:13 +00:00
### *HEAD* e *head* (componentes do diretório .git)
2022-07-16 13:52:03 +00:00
*HEAD* é a referência que aponta para a *branch* em uso. Um repositório só tem
2015-02-04 15:13:13 +00:00
uma *HEAD* activa.
*head* é uma referência que aponta para qualquer *commit*. Um repositório pode
ter um número indefinido de *heads*
### Estados no Git
* Modificado (Modified): Ocorreram mudanças em arquivo mas essas mudanças
ainda não foram registradas na base de dados do Git
* Preparado (Staged): Marca o arquivo como preparado para ser adicionado ao
próximo commit.
* Consolidado (Committed): As mudanças foram registradas na base de dados do
Git.
2015-02-04 15:13:13 +00:00
### Recursos conceituais (EN)
2015-02-04 15:13:13 +00:00
* [Git para Cientistas de Computação](http://eagain.net/articles/git-for-computer-scientists/)
* [Git para Designers](http://hoth.entp.com/output/git_for_designers.html)
## Comandos
2015-02-04 15:13:13 +00:00
### *init*
2015-02-04 15:13:13 +00:00
Cria um repositório Git vazio. As definições, informação guardada e outros do
repositório git são guardados em uma pasta chamada ".git".
```bash
$ git init
```
2015-02-04 15:13:13 +00:00
### *config*
2015-02-04 15:13:13 +00:00
Permite configurar as definições, sejam as definições do repositório, sistema
ou configurações globais.
```bash
2015-02-04 15:13:13 +00:00
# Imprime e define algumas variáveis de configuração básicas (global)
$ git config --global user.email
$ git config --global user.name
$ git config --global user.email "MyEmail@Zoho.com"
$ git config --global user.name "My Name"
```
2015-02-04 15:13:13 +00:00
[Aprenda mais sobre git config. (EN)](http://git-scm.com/docs/git-config)
### help
2015-02-04 15:13:13 +00:00
Para visualizar rapidamente o detalhamento de cada comando ou apenas lembrar da semântica.
```bash
2015-02-04 15:13:13 +00:00
# Ver rapidamente os comandos disponiveis
$ git help
# Ver todos os comandos disponíveis
$ git help -a
# Usar o *help* para um comando específico
2015-02-04 15:13:13 +00:00
# git help <comando_aqui>
$ git help add
$ git help commit
$ git help init
# ou git <comando_aqui> --help
$ git add --help
$ git commit --help
$ git init --help
```
### Ignorando arquivos
É possível intencionalmente ignorar arquivos e pastas. Costuma-se utilizar o
arquivo .gitignore para fazer o git ignorar a existência de arquivos e pastas
geralmente utilizados para arquivos privados ou temporários que, de outro modo,
seriam compartilhados com todos que tem acesso ao repositório.
```bash
$ echo "temp/" >> .gitignore
$ echo "chave_privada" >> .gitignore
```
### status
2015-02-04 15:13:13 +00:00
Apresenta as diferenças entre o arquivo *index* (a versão corrente
do repositório) e o *commit* da *HEAD* atual.
```bash
2022-07-16 13:52:03 +00:00
# Apresenta a *branch*, arquivos não monitorados, alterações e outras
# diferenças
$ git status
2015-02-04 15:13:13 +00:00
# Para aprender mais detalhes sobre git *status*
$ git help status
```
### add
2015-02-04 15:13:13 +00:00
Adiciona arquivos ao repositório corrente. Se os arquivos novos não forem
adicionados através de `git add` ao repositório, então eles não serão
incluidos nos commits!
```bash
2015-02-04 15:13:13 +00:00
# adiciona um arquivo no diretório do projeto atual
$ git add HelloWorld.java
2015-02-04 15:13:13 +00:00
# adiciona um arquivo num sub-diretório
$ git add /path/to/file/HelloWorld.c
2015-02-04 15:13:13 +00:00
# permite usar expressões regulares!
$ git add ./*.java
2022-07-16 13:52:03 +00:00
# Você também pode adicionar tudo no seu diretório de trabalho como alterações
prontas para o próximo commit.
$ git add -A
```
2022-07-16 13:52:03 +00:00
Esse comando apenas adiciona os arquivos no estado de preparados para o próximo
commit, mas não realiza o commit de fato.
### branch
2022-07-16 13:52:03 +00:00
Gerencia as *branches*. É possível ver, editar, criar e apagar branches com este
2015-02-04 15:13:13 +00:00
comando.
```bash
2015-02-04 15:13:13 +00:00
# listar *branches* existentes e remotos
$ git branch -a
2022-07-16 13:52:03 +00:00
# criar uma nova *branch*
$ git branch myNewBranch
2022-07-16 13:52:03 +00:00
# apagar uma *branch*
$ git branch -d myBranch
2022-07-16 13:52:03 +00:00
# alterar o nome de uma *branch*
# git branch -m <oldname> <newname>
$ git branch -m myBranchName myNewBranchName
2022-07-16 13:52:03 +00:00
# editar a descrição de uma *branch*
$ git branch myBranchName --edit-description
```
### Tag
Gerencia as *tags*
```bash
# Listar tags
$ git tag
# Criar uma tag anotada.
# O parâmetro -m define uma mensagem, que é armazenada com a tag.
# Se você não especificar uma mensagem para uma tag anotada,
# o Git vai rodar seu editor de texto para você digitar alguma coisa.
$ git tag -a v2.0 -m 'minha versão 2.0'
# Mostrar informações sobre a tag
# O comando mostra a informação da pessoa que criou a tag,
# a data de quando o commit foi taggeado,
# e a mensagem antes de mostrar a informação do commit.
$ git show v2.0
# Enviar uma tag para o repositório remoto
$ git push origin v2.0
# Enviar várias tags para o repositório remoto
$ git push origin --tags
```
### checkout
2015-02-04 15:13:13 +00:00
Atualiza todos os arquivos no diretório do projeto para que fiquem iguais
2022-07-16 13:52:03 +00:00
à versão do index ou da *branch* especificado.
```bash
2022-07-16 13:52:03 +00:00
# Checkout de um repositório - por padrão para a branch master
$ git checkout
2022-07-16 13:52:03 +00:00
# Checkout de uma branch especifica
$ git checkout branchName
2022-07-16 13:52:03 +00:00
# Cria uma nova branch e faz checkout para ele.
2015-02-04 15:13:13 +00:00
# Equivalente a: "git branch <name>; git checkout <name>"
$ git checkout -b newBranch
```
### clone
2015-02-04 15:13:13 +00:00
Clona ou copia um repositório existente para um novo diretório. Também
adiciona *branches* de monitoramento remoto para cada *branch* no repositório
clonado o que permite enviar alterações para uma *branch* remoto.
```bash
2015-02-04 15:13:13 +00:00
# Clona learnxinyminutes-docs
$ git clone https://github.com/adambard/learnxinyminutes-docs.git
# Clone superficial - É mais rápido, mas puxa apenas o último commit
$ git clone --depth 1 https://github.com/adambard/learnxinyminutes-docs.git
# Clona apenas uma branch em específica
$ git clone -b master-cn https://github.com/adambard/learnxinyminutes-docs.git --single-branch
```
### commit
2015-02-04 15:13:13 +00:00
Guarda o conteudo atual do index num novo *commit*. Este *commit* contém
as alterações feitas e a mensagem criada pelo usuário.
```bash
# Realize um commit com uma mensagem
$ git commit -m "Added multiplyNumbers() function to HelloWorld.c"
# Assine um commit com sua chave GPG. Antes disso, você precisa ter
# configurado a opção user.signkey do git com o comando:
# git config --global user.signinkey ID_CHAVE_AQUI
$ git commit -S -m "mensagem do commit aqui"
# Automaticamente adicione como preparados arquivos modificados ou apagados e
# então realize um commit:
$ git commit -a -m "Modified foo.php and removed bar.php"
# Altere o último commit (Esse comando reescreve o commit anterior)
$ git commit --amend -m "Correct message"
```
### diff
2015-02-04 15:13:13 +00:00
Apresenta as diferenças entre um arquivo no repositório do projeto, *index*
e *commits*
```bash
2015-02-04 15:13:13 +00:00
# Apresenta a diferença entre o diretório atual e o index
$ git diff
2015-02-04 15:13:13 +00:00
# Apresenta a diferença entre o index e os commits mais recentes
$ git diff --cached
2015-02-04 15:13:13 +00:00
# Apresenta a diferença entre o diretório atual e o commit mais recente
$ git diff HEAD
```
### grep
2015-02-04 15:13:13 +00:00
Permite procurar facilmente num repositório
Configurações opcionais:
```bash
2015-02-04 15:13:13 +00:00
# Define a apresentação de números de linha nos resultados do grep
$ git config --global grep.lineNumber true
2015-02-04 15:13:13 +00:00
# Agrupa os resultados da pesquisa para facilitar a leitura
$ git config --global alias.g "grep --break --heading --line-number"
```
```bash
2015-02-04 15:13:13 +00:00
# Pesquisa por "variableName" em todos os arquivos java
$ git grep 'variableName' -- '*.java'
2015-02-04 15:13:13 +00:00
# Pesquisa por uma linha que contém "arrayListName" e "add" ou "remove"
$ git grep -e 'arrayListName' --and \( -e add -e remove \)
```
2015-02-04 15:13:13 +00:00
O Google é seu amigo; para mais exemplos:
[Git Grep Ninja (EN)](http://travisjeffery.com/b/2012/02/search-a-git-repo-like-a-ninja)
### log
2015-02-04 15:13:13 +00:00
Apresenta commits do repositório.
```bash
2015-02-04 15:13:13 +00:00
# Apresenta todos os commits
$ git log
# Apresenta apenas mensagem do commit e referência
$ git log --oneline
2015-02-04 15:13:13 +00:00
# Apresenta apenas commits de merge
$ git log --merges
# Apresenta todos os commits representados por um gráfico em ASCII
$ git log --graph
```
### merge
2022-07-16 13:52:03 +00:00
"Merge" junta as alterações de commits externos com a *branch* atual.
```bash
2022-07-16 13:52:03 +00:00
# Junta a branch especificado com o atual
$ git merge branchName
2022-07-16 13:52:03 +00:00
# Para gerar sempre um commit ao juntar as branches
$ git merge --no-ff branchName
```
### mv
2015-02-04 15:13:13 +00:00
Alterar o nome ou mover um arquivo.
```bash
2015-02-04 15:13:13 +00:00
# Alterar o nome de um arquivo
$ git mv HelloWorld.c HelloNewWorld.c
# Mover um arquivo
$ git mv HelloWorld.c ./new/path/HelloWorld.c
2015-02-04 15:13:13 +00:00
# Forçar a alteração de nome ou mudança local
# "existingFile" já existe no directório, será sobrescrito.
$ git mv -f myFile existingFile
```
### pull
2022-07-16 13:52:03 +00:00
Puxa alterações de um repositório e as junta com outra branch
```bash
2015-02-04 15:13:13 +00:00
# Atualiza o repositório local, juntando as novas alterações
# do repositório remoto 'origin' e branch 'master'
# git pull <remote> <branch>
2015-02-04 15:13:13 +00:00
# git pull => aplica a predefinição => git pull origin master
$ git pull origin master
# Por padrão, o git irá realizar o pull na branch atual fazendo um merge
# com as alterações novas na branch remota
$ git pull
2022-07-16 13:52:03 +00:00
# Juntar alterações da branch remote e fazer rebase commits da branch
2015-02-04 15:13:13 +00:00
# no repositório local, como: "git pull <remote> <branch>, git rebase <branch>"
$ git pull origin master --rebase
```
### push
2022-07-16 13:52:03 +00:00
Enviar e juntar alterações de uma branch para a sua branch correspondente
2015-02-04 15:13:13 +00:00
num repositório remoto.
```bash
2015-02-04 15:13:13 +00:00
# Envia e junta as alterações de um repositório local
2022-07-16 13:52:03 +00:00
# para um remoto denominado "origin" na branch "master".
# git push <remote> <branch>
2015-02-04 15:13:13 +00:00
# git push => aplica a predefinição => git push origin master
$ git push origin master
# Por padrão, o git push irá enviar e realizar merge das mudanças da sua branch
# local com a branch remota
$ git push
# Para associar a branch local com uma branch específica remota, adicione a
# flag -u
$ git push -u origin master
# Agora, sempre que você realizar um push daquela branch local, use o atalho:
$ git push
```
2015-02-04 15:13:13 +00:00
### rebase (cautela!)
2022-07-16 13:52:03 +00:00
Pega em todas as alterações que foram registadas numa branch e volta a
aplicá-las em outra branch.
2015-02-04 15:13:13 +00:00
*Não deve ser feito rebase de commits que foram enviados para um repositório
público*
```bash
2015-02-04 15:13:13 +00:00
# Faz Rebase de experimentBranch para master
# git rebase <basebranch> <topicbranch>
$ git rebase master experimentBranch
```
2015-02-04 15:13:13 +00:00
[Leitura adicional (EN).](http://git-scm.com/book/en/Git-Branching-Rebasing)
2015-02-04 15:13:13 +00:00
### reset (cuidado!)
2015-02-04 15:13:13 +00:00
Restabelece a HEAD atual ao estado definido. Isto permite reverter *merges*,
*pulls*, *commits*, *adds* e outros. É um comando muito poderoso mas também
perigoso quando não há certeza do que se está fazendo.
```bash
2015-02-04 15:13:13 +00:00
# Restabelece a camada intermediária de registo para o último
# commit (o diretório fica sem alterações)
$ git reset
2015-02-04 15:13:13 +00:00
# Restabelece a camada intermediária de registo para o último commit, e
# sobrescreve o projeto atual
$ git reset --hard
2022-07-16 13:52:03 +00:00
# Move a head da branch atual para o commit especificado, sem alterar o projeto.
2015-02-04 15:13:13 +00:00
# todas as alterações ainda existem no projeto
$ git reset 31f2bb1
2022-07-16 13:52:03 +00:00
# Inverte a head da branch atual para o commit especificado
2015-02-04 15:13:13 +00:00
# fazendo com que este esteja em sintonia com o diretório do projeto
# Remove alterações não registadas e todos os commits após o commit especificado
$ git reset --hard 31f2bb1
```
2022-07-17 12:13:45 +00:00
### revert
O comando revert pode ser utilizado para desfazer um commit. Não deve ser
confundido com o comando reset que restabelece o estado do repositório para um
momento anterior. O revert irá criar um novo commit com alterações inversas a
de um outro commit especificado, portanto revertendo aquelas alterações.
```bash
# Revertendo um commit específico
$ git revert <commit>
```
### rm
2022-07-16 13:52:03 +00:00
O oposto de git add, git rm remove arquivos da branch atual.
```bash
# remove HelloWorld.c
$ git rm HelloWorld.c
2015-02-04 15:13:13 +00:00
# Remove um arquivo de um sub-directório
$ git rm /pather/to/the/file/HelloWorld.c
```
2022-07-17 12:08:59 +00:00
## Leitura complementar
2022-07-17 12:08:59 +00:00
* [Configurar o Git (GitHub Docs)](https://docs.github.com/pt/get-started/quickstart/set-up-git)
* [Learn Git Branching - the most visual and interactive way to learn Git on the web](http://learngitbranching.js.org/)
* [Udemy Git Tutorial: A Comprehensive Guide](https://blog.udemy.com/git-tutorial-a-comprehensive-guide/)
* [Git Immersion - A Guided tour that walks through the fundamentals of git](http://gitimmersion.com/)
* [git-scm - Video Tutorials](http://git-scm.com/videos)
* [git-scm - Documentation](http://git-scm.com/docs)
* [Atlassian Git - Tutorials & Workflows](https://www.atlassian.com/git/)
* [SalesForce Cheat Sheet](https://na1.salesforce.com/help/doc/en/salesforce_git_developer_cheatsheet.pdf)
2022-07-17 12:08:59 +00:00
* [Git - the simple guide](http://rogerdudler.github.io/git-guide/index.html)
* [Pro Git (em Português)](https://www.git-scm.com/book/pt-br/v2)
* [An introduction to Git and GitHub for Beginners (Tutorial)](http://product.hubspot.com/blog/git-and-github-tutorial-for-beginners)
* [The New Boston tutorial to Git covering basic commands and workflow](https://www.youtube.com/playlist?list=PL6gx4Cwl9DGAKWClAD_iKpNC0bGHxGhcx)