Versionando códigos com Git e Github

Versionando códigos com
Git e Github

Quem somos

Ana Carolina

Estudante de Análise e Desenvolvimento de Sistemas
Software Developer na Love Mondays
Experiência em Python, Web Scraping e crawling
Mais informações em about.me

Lucas Marques

Formado em Análise e Desenvolvimento de Sistemas
Software Developer no Grupo Viceri
Experiência em tecnologias Microsoft
Mais informações em about.me

Versionamento de código

Versionamento de código?
Sistema que registra mudanças feitas em um arquivo (ou num conjunto de arquivos), permitindo recuperar versões específicas.

Por que é necessário?
Mantém todas as versões em um único local, permitindo controlar tudo que está sendo desenvolvido no projeto.

Exemplo de imagem do porque devemos utilizar git

Git e GitHub

Git
Sistema de controle de versão de arquivos. Permite desenvolver projetos, nos quais várias pessoas podem contribuir, sem riscos de alterações serem sobrescritas por engano.

GitHub
Serviço web que oferece diversas funcionalidades aplicadas ao git. Pode ser usado para hospedar projetos de maneira gratuita.

Hands-on

Pré requisitos:

Ter o git instalado no computador (link para download);
Ter uma conta no GitHub (link para criar conta).

Hands-on

Criando o repositório remoto

Crie um novo repositório no GitHub.

Hands-on

Hands-on

Criando o repositório local

Crie uma pasta na área de trabalho;
Abra a pasta, clique com o botão direito e selecione 'Git Bash Here';
Digite git init (esse comando vai inicializar o git dentro dessa pasta);
Adicione as configurações globais do git usando os comandos:
git config --global user.name "seu_username" git config --global user.email "seu_email"

Hands-on

Vinculando o repositório remoto ao repositório local

Você pode vincular seus repositórios usando HTTPS ou SSH;
Usar HTTPS é uma forma mais simples;
Usar SSH é uma forma mais segura;
Aqui vamos usar HTTPS, mas se você quiser usar SSH pode fazer o setup seguindo essas orientações do GitHub.

Hands-on

Vinculando o repositório remoto ao repositório local

Copie o link do seu repositório na página inicial dele;
Não se esqueça de selecionar de acordo com o protocolo a ser usado (HTTPS ou SSH).

Hands-on

Ligando o repositório remoto ao repositório local

Para ligar o repositório remoto ao repositório local, use o comando
git remote add origin link_do_repositorio
Fazendo essa ligação, é possível sincronizar manualmente, através de comandos git, suas alterações entre os repositórios.

Hands-on

Dentro da sua pasta local crie um arquivo git-workshop.txt e salve;
No terminal git digite git status ;
Esse comando vai mostrar todos os arquivos alterados.

Hands-on

Para adicionar as alterações, use git add nome_do_arquivo ;
Se tiver mais de um arquivo e quiser adicionar todos, use git add .

Hands-on

Faça um git status e verá que agora está tudo pronto para o próximo passo, fazer um commit.

Git status depois de adicionar o arquivo

O que é um commit?

Commit é um pacote fechado com todas as alterações que você fez para o seu projeto.

Hands-on

Você pode fazer um commit mais detalhado, contendo título e descrição usando git commit ;
Ou de uma maneira mais simples, só adicionando o título
git commit -m "Sua mensagem aqui" ;
Errou a mensagem do commit?
git commit -m "Sua mensagem corrigida aqui" --amend ;
O comando git commit --amend sobrescreve o último commit.

Hands-on

Faça um git log para conferir seus commits.
Se estiver tudo certo, o próximo passo é fazer um push para o branch remoto.

O que é um branch?

Branch é uma ramificação de um projeto;
Temos o branch principal master;
Criamos "cópias" do branch principal para fazer alterações sem correr o risco de alterar o principal;
Por enquanto, estamos usando o branch master para inicializar os dois repositórios.

Hands-on

O próximo passo é enviar suas alterações locais para o repositório remoto, para isso, use git push ;
Se você digitar git push , vai perceber que o git te pede para fazer o push usando git push --set-upstream origin nome_da_branch ;
Isso acontece porque como é a primeira vez que um push está sendo feito nesse branch, é necessário referenciar a origem para que o branch seja criado remotamente.

Hands-on

Para resumir, use
git push -u origin nome_do_seu_branch ;
Como o branch usado é o master: git push -u origin master ;
Para próximos push no mesmo branch você pode usar só git push .

Hands-on

Agora, se você olhar seu repositório no GitHub, vai ver que ele contém o seu arquivo.

Hands-on

Vamos colocar conteúdo no arquivo git-workshop.txt ;
Primeiro, crie um novo branch usando
git checkout -b editando-arquivo ;
Agora, edite o arquivo git-workshop.txt escrevendo alguma coisa dentro dele.

Hands-on

Verifique se o arquivo foi realmente alterado usando git status ;
Veja exatamente o que foi alterado usando git diff .

Hands-on

Adicione ao pacote de alterações usando git add git-workshop.txt ;
Faça um novo commit git commit -m "Sua mensagem aqui" ;
Faça um push para o novo branch
git push -u origin editando-arquivo ;

Hands-on

Verifique o repositório no GitHub;
Agora o repositório contém 2 branches;
O arquivo está diferente em cada um dos branches;
Para unificar os dois branches é necessário fazer um merge.

O que é um merge?

O merge é responsável por juntar os commits dos branches que você criou incluindo na linha do tempo do branch desejado. Na maioria dos casos isso é feito no branch master.

Hands-on

Antes de realizar um merge, é necessário selecionar o branch que receberá as atualizações, no nosso caso git checkout master ;
Agora o merge já pode ser realizado: git merge editando-arquivo ;
Feito isso, é só executar o comando git push origin master que ele irá atualizar o seu branch master remoto;
Agora você verá suas alterações no branch master.

Colaborando em
projetos

Colaborando em projetos

Quando você deseja colaborar com o projeto de alguém, o primeiro passo é fazer um 'Fork' no repositório da pessoa;
Isso vai criar um repositório igual ao dela, no seu GitHub;
A partir daí, você pode realizar um git clone no seu repositório, fazer alterações e fazer pull requests.

Pull Request

Para que suas alterações sejam vinculadas ao branch principal de um projeto que não é seu, você precisa abrir um Pull Request.
O Pull Request significa que você está enviando uma sugestão de melhoria para o repositório.

Colaborando em projetos

Vamos colaborar no projeto 'participants-git-workshop', criado para esse workshop;
Nesse projeto você adicionará algumas informações: seu nome, uma breve descrição sobre você e seu perfil do GitHub.

Hands-on

Faça um fork nesse repositório;
Você será direcionado para a sua cópia do repositório;
Copie o link para clonar seu repositório.

Hands-on

Vá até a pasta onde você deseja adicionar o novo repositório, clique com o botão direito e depois em 'Git Bash Here';
Faça um git clone link_do_repositorio ;
Abra a pasta criada usando cd participants-git-workshop ;
Crie uma nova branch
git checkout -b adicionando-seu_nome-profile ;

Hands-on

Abra e edite o arquivo index.html ;

Adicione informações sobre você, seguindo o padrão:

                                <article>
                                    <strong>seu_nome</strong>
                                    <p>Uma breve descrição sobre você</p>
                                    <a href="url_do_seu_github">Github</a>
                                </article>

Hands-on

Faça git status ;
Confira se adicionou certo usando git diff ;
Adicione a alteração git add index.html ;
Faça um commit
git commit -m "Adicionando informações de seu_nome" ;
Envie o commit para o seu branch
git push -u origin nome_do_seu_branch .

Hands-on

Nosso próximo passo é abrir um Pull Request;
No seu repositório do GitHub você vai ver um novo branch;
Clique em branches para ver todos os branches do seu projeto;
Para abrir um Pull Request, basta clicar em 'New pull request' ao lado do seu branch.

Hands-on

Na página de Pull Request você conseguirá identificar algumas informações importantes;

Hands-on

base fork: repositório para o qual você está mandando as alterações;
base: branch onde deseja inserir as alterações;
head fork: seu repositório (cópia do repositório original da outra pessoa);
compare: branch que contém as alterações que você deseja enviar;

Hands-on

Se desejar, adicione uma mensagem de descrição para o pull request;
Crie o pull request;
Acompanhe, o moderador do repositório pode comentar, aprovar ou solicitar mudanças.

Outro comando importante

git pull

Esse comando atualiza seu branch local de acordo com o branch remoto.

Hacktoberfest

Hacktoberfest é um evento promovido pela DigitalOcean em parceria com o Github

Cadastre seu usuario github no site oficial do Hacktoberfest;
Procure no GitHub issues com a label 'hacktoberfest';
Abra 5 pull requests até o dia 31 de outubro;
Acompanhe o seu progresso utilizando o Hacktoberfest Checker;
Receba uma camiseta do evento!!!