Skip to content

08-github.md

Latest commit

 

History

History
137 lines (111 loc) · 3.66 KB

08-github.md

File metadata and controls

137 lines (111 loc) · 3.66 KB

🌐 Trabalhando com GitHub

O GitHub é uma plataforma online que hospeda repositórios Git e facilita a colaboração em equipe, controle de versões e integração com ferramentas externas.
Nesta seção, você aprenderá a configurar SSH, trabalhar com repositórios remotos, sincronizar forks e fechar issues diretamente via commits.

🔑 1. Configurando SSH para autenticação

Evita digitar usuário e senha toda vez que enviar ou baixar alterações.

# Gerar uma nova chave SSH
ssh-keygen -t rsa -b 4096 -C "seuemail@exemplo.com"

# Visualizar chave pública (Linux)
cat ~/.ssh/id_rsa.pub

# Visualizar chave pública (Mac)
cat /Users/<usuario>/.ssh/id_rsa.pub

Adicionando a chave ao GitHub

  1. Acesse Settings > SSH and GPG keys > New SSH key.
  2. Cole a chave pública e defina um título identificando sua máquina.
  3. Teste a conexão:
ssh -T git@github.com

💡 Dica: Use sempre uma chave por máquina e nunca compartilhe a privada.

📦 2. Trabalhando com repositórios remotos

Adicionando um repositório remoto

git remote add origin git@github.com:usuario/repositorio.git

Verificando repositórios remotos

git remote -v

Alterando a URL do remoto

git remote set-url origin git@github.com:usuario/repositorio.git

Removendo um repositório remoto

git remote rm origin

Enviando alterações

git push origin main

Baixando alterações

git fetch origin
git pull origin main

💡 Dica: Sempre use git fetch antes de git pull para revisar alterações remotas.

🔀 3. Trabalhando com Fork e Upstream

Quando você deseja contribuir para um repositório de outra pessoa:

  1. Faça um fork no GitHub.
  2. Clone seu fork localmente:
git clone git@github.com:seuusuario/repositorio.git
  1. Adicione o repositório original como upstream:
git remote add upstream git@github.com:autor-original/repositorio.git
  1. Sincronize alterações do upstream:
git fetch upstream
git checkout main
git merge upstream/main

💡 Dica: Mantenha seu fork atualizado para evitar conflitos antes de criar pull requests.

📝 4. Fechando Issues via Commit

Você pode fechar automaticamente uma issue quando o commit for mergeado:

git commit -m "Corrige bug de login - fix #42"

Palavras-chave suportadas pelo GitHub:

fix, fixes, fixed, close, closes, closed, resolve, resolves, resolved

O número da issue vem da URL: ex: #42.

⚠️ Boas práticas e cuidados

  • Nunca compartilhe sua chave SSH privada.
  • Evite push -f em branches compartilhadas.
  • Trabalhe sempre em branches de feature ou bugfix.
  • Antes de abrir um pull request, sincronize sua branch:
git fetch upstream
git rebase upstream/main

ou

git merge upstream/main
  • Use mensagens de commit claras e semânticas (feat:, fix:, chore:).
  • Para alterações grandes, prefira pull requests pequenos.
  • Verifique status e histórico antes de enviar:

git status
git log --oneline --graph --decorate

🌳 Fluxo Visual - GitHub e Repositórios Remotos

flowchart TD
    Local[Repositório Local] -->|git push| Origin[GitHub - seu fork]
    Origin -->|pull request| Upstream[GitHub - repositório original]
    Upstream -->|merge PR| Origin
    Local -->|git fetch upstream| Upstream
Loading

💡 Resumo Rápido

  • Configure SSH para autenticação sem senha.
  • Sempre crie branches separadas para cada feature ou correção.
  • Mantenha forks atualizados com o upstream.
  • Feche issues via commit usando palavras-chave.
  • Revise alterações e histórico antes de push ou merge.