Modulo 4 / Git e GitHub

GitHub

Repositórios remotos, push, pull e pull requests.

school Aula 20 schedule 2 horas

Plataforma

O que é o GitHub?

cloud Repositórios na nuvem

▸ Plataforma que hospeda repositórios Git online
▸ Backup do seu código na nuvem
▸ Facilita a colaboração entre desenvolvedores
▸ Seu portfólio profissional como desenvolvedor

star Funcionalidades

folder Repositórios públicos e privados

merge Pull Requests para revisão de código

bug_report Issues para gerenciar tarefas/bugs

rocket_launch GitHub Pages para deploy gratuito

play_circle GitHub Actions para automação (CI/CD)

Primeiros passos

Criando um repositório remoto

person_add Conta no GitHub

1 Acesse github.com e crie uma conta

2 Use o mesmo email configurado no Git

3 Escolha um username profissional

add_circle Novo repositório

1 Clique no botão "+" e "New repository"

2 Dê um nome (ex: meu-site)

3 Escolha público ou privado

4 Nao inicialize com README (já temos código local)

Conexão

Local para remoto

link Conectar repositório existente

# Adicionar o repositório remoto
$ git remote add origin
  https://github.com/usuario/meu-site.git

# Verificar remotos configurados
$ git remote -v
origin  https://github.com/...  (fetch)
origin  https://github.com/...  (push)

# Primeiro push (envia para o GitHub)
$ git push -u origin main

content_copy Clonar repositório existente

# Baixar um repositório do GitHub
$ git clone
  https://github.com/usuario/projeto.git

# Já vem com o remote configurado!
$ cd projeto
$ git remote -v
origin  https://github.com/...  (fetch)
origin  https://github.com/...  (push)

lightbulb origin é o nome padrão dado ao repositório remoto. Pode ser qualquer nome, mas a convenção é usar "origin".

Sincronização

Push e Pull

cloud_upload git push

# Enviar commits locais para o GitHub
$ git push origin main

# Após o primeiro push com -u,
# pode usar apenas:
$ git push

▸ Envia seus commits locais para o repositório remoto

▸ Outros desenvolvedores podem ver e baixar suas mudanças

cloud_download git pull

# Baixar mudanças do GitHub
$ git pull origin main

# Ou simplesmente:
$ git pull

▸ Baixa os commits que outros fizeram no repositório remoto

▸ Combina automaticamente com seu código local (merge)

Local git push GitHub git pull Local

Importante

O arquivo .gitignore

visibility_off Ignorando arquivos

# .gitignore

# Dependências
node_modules/

# Arquivos do sistema
.DS_Store
Thumbs.db

# Arquivos de ambiente
.env
.env.local

# Build
dist/
build/

info Por que ignorar?

▸ node_modules/ pode ter milhares de arquivos (instalados via npm)
▸ .env contém dados sensíveis (senhas, chaves de API)
▸ .DS_Store é arquivo de sistema do macOS
▸ Cada linguagem/framework tem seu template de .gitignore

lightbulb Acesse gitignore.io para gerar um .gitignore para sua stack.

Documentação

O arquivo README.md

# README.md

# Meu Site Pessoal

Site pessoal desenvolvido com HTML,
CSS e JavaScript.

## Funcionalidades

- Página inicial responsiva
- Portfólio com projetos
- Formulário de contato

## Tecnologias

- HTML5
- CSS3
- JavaScript

## Como usar

1. Clone o repositório
2. Abra `index.html` no navegador

description Boas práticas

▸ Título e descrição clara do projeto
▸ Lista de funcionalidades e tecnologias
▸ Instruções de como rodar o projeto
▸ Screenshots (opcional, mas impressiona)
▸ Escrito em Markdown (.md)

lightbulb O GitHub renderiza o README.md automaticamente na página do repositório. É a primeira coisa que as pessoas veem.

Colaboração

Pull Requests

rate_review O que é um PR?

▸ Pedido para incluir suas mudanças na branch principal
▸ Permite que outros revisem o código antes do merge
▸ Espaço para discussão e sugestões
▸ Garante qualidade do código em equipe

checklist Fluxo do PR

1 Crie uma branch e faça suas mudanças

2 Push da branch para o GitHub

3 No GitHub, clique "New Pull Request"

4 Descreva o que foi feito e solicite revisão

5 Após aprovação, faça o merge pelo GitHub

Na prática

Branches remotas

# 1. Criar branch local
$ git switch -c nova-feature

# 2. Fazer alterações e commits
$ git add .
$ git commit -m "Implementa nova feature"

# 3. Enviar branch para o GitHub
$ git push -u origin nova-feature

# 4. No GitHub, criar Pull Request da branch "nova-feature" para "main"
#    Outros revisam e aprovam

# 5. Após o merge no GitHub, voltar para main local
$ git switch main
$ git pull

# 6. Deletar a branch local
$ git branch -d nova-feature

lightbulb A flag -u em git push -u origin nova-feature configura o tracking. Depois disso, basta usar git push sem argumentos.

Hora de praticar

Exercício prático

rocket_launch Publicar projeto no GitHub

Crie uma conta no GitHub (se ainda nao tiver)
Crie um repositório chamado meu-site no GitHub
No seu repositório local, adicione um .gitignore e um README.md
Conecte o repositório local ao remoto com git remote add origin ...
Faça o push com git push -u origin main
Verifique no GitHub se os arquivos aparecem
Crie uma branch, faça mudanças, push e abra um Pull Request

lightbulb Desafio extra: convide um colega para colaborar e pratiquem o fluxo de fork, clone, branch, commit, push e PR.

Próxima aula

Aula 21

Colaboração em equipe. GitHub Pages para deploy.

task_alt O que aprendemos hoje

check_circle O que é o GitHub e suas funcionalidades
check_circle Criar repositório no GitHub e conectar com local
check_circle git push, git pull e git clone
check_circle Arquivos .gitignore e README.md
check_circle Pull Requests e fluxo de colaboração

Próxima aula

auto_stories Referência: GitHub Docs (PT-BR)