O documento discute Git e GitHub, ferramentas para controle de versão de código-fonte. Git permite gerenciar versões de código localmente ou em um servidor, enquanto GitHub é uma plataforma na nuvem para hospedagem de projetos Git. O texto explica conceitos como branches, commits, fluxo de trabalho e demonstra passo a passo como utilizar comandos Git localmente e na nuvem com GitHub.

1. Repositórios GitHub
Gerenciando projetos com Git
Daniel Destro do Carmo
Fevereiro 2018

2. Conteúdo
Git versus GitHub
Controle de Versão
Entendendo Git
• O que é e como funciona?
• Gerenciamento de branches
• Fluxo de trabalho
• Praticando o Git
Entendendo GitHub
• O que é e como funciona?
• Gerenciamento de repositórios
• Praticando o Git com GitHub
• Pull Request & Code Review
2

3. Git versus GitHub
Git e GitHub não são a mesma coisa
Eles trabalham em conjunto para gerenciar repositórios de código-fonte
Ambos ajudam no controle de versão do código-fonte do seu projeto
Basicamente:
3
Git é um software instalado no
computador do desenvolvedor
e/ou no servidor para gerenciar
as versões do código-fonte do
seu projeto.
GitHub é uma plataforma de
hospedagem de código-fonte
na nuvem (ou em um servidor
local) com controle de versão
usando o Git.

4. Controle de Versão
Sistemas de controle de versão de código-fonte de software:
– São ferramentas que ajudam os times de desenvolvimento a gerenciar
mudanças dos projetos.
– Mantém o registro de toda e qualquer modificação feita no código-fonte
em um repositório de código.
– Auxilia e acelera o desenvolvimento, permitindo comparar diferentes
versões do código-fonte, fazer uma junção delas e o gerenciamento de
possíveis conflitos.
– Permite acessar qualquer versão do código existente no passado.
– Ajuda prevenir e remediar erros cometidos por desenvolvedores no
código, possibilitando reverter as mudanças feitas.
4

5. Entendendo Git
5

6. Entendendo Git
O que é Git?
Git é um sistema de gerenciamento de código-fonte com controle de versão distribuído
Cada desenvolvedor mantém uma cópia do histórico de mudanças do repositório, tornando-o distribuído
Projetado e desenvolvido em 2005 por Linus Torvalds, o criador do kernel Linux
Software livre, distribuído sob os termos da versão 2 da GNU General Public License
Sistema de controle de versão de código-fonte mais utilizado no mundo
Website oficial: https://git-scm.com
Faça o download do Git e instale no seu computador de desenvolvimento
Windows: https://gitforwindows.org
Linux: https://git-scm.com/download/linux
6

7. Entendendo Git
Funcionamento Básico
O cenário ideal é seu projeto ter um servidor rodando Git atuando como um repositório central
Você pode instalar Git em um servidor próprio ou usar uma plataforma na nuvem (GitHub, BitBucket, etc)
Cada desenvolvedor do time precisa instalar Git no seu computador para gerenciar os fontes dos projetos
Preferencialmente, cada projeto é gerenciado em um repositório Git diferente
O desenvolvedor pode criar um novo repositório localmente ou “clonar” um existente no servidor Git
O repositório local do desenvolvedor deve estar conectado a um repositório remoto no servidor Git
Este repositório local é uma cópia do repositório remoto, que pode ser modificado e depois sincronizado
Git usa um sistema baseado em árvore e ramos (branch) para controlar diferentes versões do código-fonte
7

8. Entendendo Git
Gerenciamento de Branches
Geralmente o Git tem o código-fonte principal no branch chamado “master” (versão em produção)
O desenvolvedor criar um novo branch para cada funcionalidade nova ou mudança (bug / correção, etc)
Assim que terminar as alterações e estiver tudo pronto, pode integrar as mudanças para o ”master”
Você pode baixar (pull) as mudanças de um branch para atualizar seu respositório e evitar futuros conflitos
8
master
feature-1
Versão 1.0.0
feature-2
mastermaster
bug-fix-1
Versão 1.0.1 Versão 1.1.0
<< branch >>
<< branch >> << merge >>
<< merge >>
<< merge >>
master
feature-1
Versão 1.2.0
2
1
2
1
3
3
4
4
3
3
<< pull >>

9. Entendendo Git
Fluxo de Trabalho
Git trabalha com três estágios da versão local do código:
Working Directory (código atual) – onde altera o código de trabalho
Index (área temporária) – onde adiciona o código alterado (stage)
HEAD (última versão) – quando confirma as alterações feitas (commit)
Qualquer alteração no código local é efetivada apenas após a confirmação da mudança (commit)
As mudanças confirmadas localmente precisam ser enviadas para o servidor remote (push) posteriormente
Mudanças enviadas por outros desenvolvedores podem ser baixadas do servidor (pull) localmente
9

10. Entendendo Git
Fluxo de Trabalho
Fluxo básico de trabalho no Git:
– Altera o código no diretório de trabalho
– Adiciona as alterações na área temporária (add)
– Efetiva as alterações no repositório local (commit)
– Envia as alterações para o repositório remoto (push)
– Baixa as alterações feitas no repositório remote (pull)
– Acessa um branch do repositório local ou remoto (checkout)
– Integra as mudanças de outro branch para o atual (merge)
10

11. Git
Praticando o Git
11

12. Entendendo Git
Praticando o Git localmente
Configurações iniciais do ambiente Git:
Primeiro vamos configurar o ambiente Git
Abra uma tela de comando (prompt or bash)
Configure o ambiente com seu nome e e-mail:
git config --global user.name “Neymar Junior”
git config --global user.email neymar@gmail.com
Habilite cores:
git config --global color.ui auto
Verifique as configurações:
git config --list
12

13. Entendendo Git
Praticando o Git localmente
Crie seu primeiro repositório, alterações e commit:
Crie uma pasta (diretório) onde vai armazenar o código-fonte do seu projeto
Abra uma tela de comando (prompt or bash) na pasta criada
Inicie a pasta como um repositório Git (git init) – o branch master será criado
Crie um arquivo texto, altere seu conteúdo e salve-o (ex: “teste.txt”)
Adicione o arquivo alterado na área temporária (git add teste.txt)
Efetive a mudança de código criando um commit (git commit -m “primeiro teste”)
Liste o conteúdo da pasta e verá apenas um arquivo (teste.txt) – comando dir no Windows ou ls no Linux
Verifique o branch em que seu diretório de trabalho se encontra (git branch)
Veja o histórico de alterações do repositório (git log)
Este é o conteúdo atual do branch master do seu repositório local
13

14. Entendendo Git
Praticando o Git localmente
Gerenciando branches e novas alterações:
Crie um novo branch para uma nova alteração (git checkout -b novo_teste)
Altere o arquivo criado anteriormente e salve-o (ex: “teste.txt”)
Crie outro arquivo texto, altere seu conteúdo e salve-o (ex: “novo.txt”)
Adicione os arquivos alterados na área temporária (git add *)
Efetive a nova mudança de código (git commit -m “teste 2”)
Liste o conteúdo da pasta e verá dois arquivos (teste.txt e novo.txt)
Verifique o branch em que seu diretório de trabalho se encontra (git branch)
Veja o histórico de alterações do repositório (git log)
Mude para o branch master (git checkout master)
Liste o conteúdo da pasta e verá apenas um arquivo (teste.txt)
Agora seu repositório local tem dois branches com versões diferentes
14

15. Entendendo Git
Praticando o Git localmente
Integrando branches:
Suponha que queira integrar as alterações do branch novo_teste para o master
Mude para o branch master (git checkout master)
Liste o conteúdo da pasta e verá apenas um arquivo (teste.txt)
Integre o conteúdo do branch novo_test para o master (git merge novo_teste)
Liste o conteúdo da pasta e verá dois arquivos (teste.txt e novo.txt)
Verifique o branch em que seu diretório de trabalho se encontra (git branch)
Veja o histórico de alterações do repositório (git log)
Agora seu repositório local tem dois branches com versões iguais
15

16. Entendendo Git
Praticando o Git localmente
Removendo branches:
Suponha que queira remover o branch novo_teste pois já finalizou as alterações
Certifique-se de que não está no branch novo_teste (git branch)
Se estiver, mude para o branch master (git checkout master)
Liste os branches do seu repositório local (git branch)
Remove o branch novo_teste (git branch -d novo_teste)
Veja o histórico de alterações do repositório (git log)
Liste os branches do seu repositório local (git branch) – somente o master deve aparecer
Agora seu repositório local tem apenas o branch master
No entanto, as modificações feitas não se perderam, pois estão em master
16

17. Entendendo Git
Praticando o Git localmente
Visualizando o histórico dos branches:
Vamos brincar um pouco com os branches e visualizar seu histórico
Crie um novo branch e um arquivo (um.txt) e commit (git checkout -b novo1) (git add *) (git commit -m “um”)
Crie outro branch e outro arquivo (dois.txt) e commit (git checkout -b novo2) (git add *) (git commit -m “dois”)
Mude para o branch master e faça um merge do branch novo1 (git checkout master) (git merge novo1)
Crie um novo arquivo (tres.txt) e commit (git add tres.txt) (git commit -m “tres”)
Mude para o branch novo1, altere o arquivo um.txt e commit (git checkout novo1) (git commit -am “quatro”)
Mude para o branch novo2, altere o arquivo dois.txt e commit (git checkout novo2) (git commit -am “cinco”)
Abra a interface GitK para visualizar as alterações e todo o histórico (gitk)
17

18. Entendendo Git
Praticando o Git localmente
Criando etiquetas:
É possível etiquetar (tag) um commit para facilitar sua identificação futura
Mude para o branch desejado para criar a etiqueta (git checkout master)
Crie a etiqueta com um nome significativo (git tag versao-1)
A estiqueta criada aponta para aquela versão específica do código
Verifique todas as etiquetas existentes no repositório (git tag)
Crie um novo arquivo, salve-o e commit (git add *) (git commit -m “mais uma versao”)
Seu repositório agora está em uma versão diferente daquela da etiqueta criada
Mude o diretório de trabalho para a versão da etiqueta (git checkout versao-1)
Para retornar para a versão do branch master (git checkout master)
18

19. Entendendo GitHub
19

20. Entendendo GitHub
O que é GitHub?
GitHub é uma plataforma de hospedagem de código-fonte com controle de versão usando o Git.
Desenvolvedores e usuários cadastrados na plataforma contribuirem em projetos privados e/ou Open
Source de qualquer lugar do mundo.
São mais de 77 milhões de projetos gerenciados pela plataforma do GitHub.
GitHub Enterprise permite criar um ambiente GitHub em sua própria empresa e gerenciá-lo privadamente.
Resumidamente: GitHub atua como seu servidor Git onde você criar e armazena seu repositório remoto.
Website oficial: https://github.com
Entre no site e crie uma conta pessoal gratuitamente.
Baixe e instale o GitHub Desktop: https://desktop.github.com
20

21. Entendendo GitHub
Gerenciamento de Repositórios
Seu repositório (público ou privado) pode ser acessado por múltiplos usuários.
Usuários podem ter diferentes tipos de permissão de acesso (administração, escrita e leitura).
Você pode conectar seu repositório local com os repositórios remotos armazenados no GitHub.
21

22. Entendendo GitHub
Gerenciamento de Repositórios
Acesse o GitHub com sua conta pessoal para gerenciar seus repositórios (públicos) gratuitamente.
Crie um novo projeto (repositório), forneça um nome e uma breve descrição.
22
Seu repositório foi criado e agora tem acesso a ele.
Aqui pode ver os fontes, branches, commits, pull
requests, releases e todo seu histórico.

23. GitHub
Praticando o Git com GitHub
23

24. Entendendo GitHub
Praticando o Git com GitHub
Clonar um repositório do GitHub localmente e fazer alterações:
Na página do seu novo repositório, clique no botão “Clone or download”
Copie o endereço HTTPS do seu repositório que aparece na caixa de diálogo (ou use a opção SSH)
Abra uma tela de comando (prompt or bash) na pasta onde deseja criar o seu repositório local
Faça o clone do repositório remoto (git clone https://github.com/<usuario>/myrepo.git)
O Git vai criar uma pasta com o nome do seu repositório (myrepo), acesse ela via comando cd
Crie um arquivo texto, altere seu conteúdo, salve e adicione ao stage (ex: “teste.txt”) (git add teste.txt)
Efetive a mudança de código criando um commit (git commit -m “meu teste”)
Envie a mudança para o repositório remoto (git push origin master)
Veja o arquivo adicionado e o histórico de mudanças na página do repositório
24

25. Entendendo GitHub
Praticando o Git com GitHub
Trabalhando com um time de desenvolvedores:
Imagine que você trabalha com um time de desenvolvedores que alteram o mesmo projeto (repositório)
As modificações desses desenvolvedores são enviadas para o servidor do GitHub (repositório remoto)
Você precisa atualizar seu repositório local com as alterações efetivadas no repositório remoto
Simule uma alteração no arquivo criado. Vá na página do repositório, clique no arquivo desejado e altere-o
Baixe as atualizações para seu repositório local (git pull origin master)
Confira se o seu arquivo local foi alterado conforme alterado na página do GitHub
Quer praticar mais?
https://try.github.io/
25

26. Entendendo GitHub
Pull Request & Code Review
Pull Request permite o desenvolvedor comunicar ao seu time as alterações enviadas ao servidor GitHub
Todos podem fazer um Code Review (CR), ou seja, revisar as alterações feitas
No Code Review podem colaborar com comentários e sugestões, aprovar ou rejeitar as mudanças
Sempre crie um Pull Request (PR) para cada branch que pretende revisar e/ou integrar ao master
Na página do respositório crie um novo Pull Request
Selecione os branches que quer comparar no PR
Todo histórico de mudanças é exibido no Pull Request
O time pode revisar, colaborar e aprovar ou rejeitar o PR
Uma vez aprovado, o PR pode ser integrado (merge)
26
master
feature-1
Versão 1.0.0
master
Versão 1.1.0
branch
commits
Code
Review
Pull
Request
merge
Saiba mais:
https://help.github.com/articles/about-pull-requests/

27. Obrigado!
Daniel Destro do Carmo
27