Nivelamento de Git e Github

Guia simples e direto para introdução ao Git e ao GitHub, ideal para iniciantes que querem começar rapidamente.

Site de referência sobre git:

https://rogerdudler.github.io/git-guide/index.pt_BR.html

1. O que é Git e GitHub

Git: Sistema de controle de versão. Permite rastrear mudanças em arquivos e colaborar com outras pessoas.
GitHub: Plataforma online para armazenar repositórios Git e colaborar com outros desenvolvedores.

2. Instalação do Git

No Windows

Baixe de: https://git-scm.com
Use o PowerShell ou Git Bash após a instalação.

No Linux

sudo apt update
sudo apt install git

3. Configuração inicial

Configure seu nome e e-mail (usado para identificar suas alterações):

git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"

4. Criar um repositório Git local

Crie uma nova pasta e inicialize o repositório:

mkdir meu-projeto
cd meu-projeto
git init

Isso cria a pasta .git, onde o Git rastreia as mudanças.

5. Fluxo básico de trabalho com Git

Adicionar arquivos e fazer commit

echo "Hello, Git" > readme.txt    # cria um arquivo de exemplo
git add readme.txt                # adiciona ao stage
git commit -m "Adiciona readme"  # salva as alterações com uma mensagem

Ver o status e histórico

git status       # mostra arquivos modificados e não rastreados
git log          # mostra o histórico de commits

6. Conectar ao GitHub

Criar um repositório no GitHub

Acesse https://github.com
Clique em "New repository"
Crie o repositório vazio (sem README, .gitignore, etc.)

Conectar seu repositório local ao remoto

git remote add origin https://github.com/usuario/repositorio.git
git branch -M main
git push -u origin main

7. Clonar um repositório existente

Para baixar um repositório do GitHub:

git clone https://github.com/usuario/repositorio.git

8. Atualizar repositório local com mudanças remotas

git pull origin main

9. Subir alterações para o GitHub

git add .
git commit -m "mensagem das alterações"
git push origin main

Resumo dos comandos principais

Ação	Comando
Iniciar repositório	`git init`
Ver status	`git status`
Adicionar arquivos	`git add nome_arquivo` ou `git add .`
Fazer commit	`git commit -m "mensagem"`
Ver histórico	`git log`
Conectar ao remoto	`git remote add origin <url>`
Enviar para o remoto	`git push origin main`
Atualizar do remoto	`git pull origin main`
Clonar repositório	`git clone <url>`

10. Usando SSH com o GitHub

SSH é uma forma segura de se conectar ao GitHub sem precisar digitar usuário e senha toda vez que fizer push ou pull.

10.1 Verificar se você já tem uma chave SSH

ls ~/.ssh/id_ed25519.pub

Se aparecer o arquivo, você já tem uma chave. Caso contrário, siga os passos abaixo.

10.2 Criar uma nova chave SSH

No Linux ou Git Bash (Windows)

ssh-keygen -t ed25519 -C "seu@email.com"

Pressione Enter para aceitar o local padrão (~/.ssh/id_ed25519)
Pode deixar a senha em branco se quiser (ou use uma, se preferir mais segurança)

No PowerShell (Windows)

Use o mesmo comando acima. Certifique-se de ter o OpenSSH instalado (já vem com o Windows 10/11 recentes).

10.3 Adicionar a chave SSH ao agente

Linux / Git Bash

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

PowerShell

Start-Service ssh-agent
ssh-add $env:USERPROFILE\.ssh\id_ed25519

10.4 Adicionar sua chave pública ao GitHub

Copie o conteúdo da sua chave pública:

Linux / Git Bash

cat ~/.ssh/id_ed25519.pub

PowerShell

Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub

Vá para https://github.com/settings/keys
Clique em "New SSH key"
Cole o conteúdo da chave e clique em "Add SSH key"

10.5 Testar conexão com GitHub

ssh -T git@github.com

Se tudo estiver certo, a resposta será parecida com:

Hi usuario! You've successfully authenticated, but GitHub does not provide shell access.

10.6 Usar SSH em vez de HTTPS nos repositórios

Quando for clonar um repositório, use a URL SSH:

git clone git@github.com:usuario/repositorio.git

Se você já clonou via HTTPS e quer mudar para SSH:

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

Resumo da seção SSH

Etapa	Comando (Linux/Git Bash)	Comando (PowerShell)
Criar chave	`ssh-keygen -t ed25519 -C "email"`	Mesmo comando
Iniciar agente	`eval "$(ssh-agent -s)"`	`Start-Service ssh-agent`
Adicionar chave ao agente	`ssh-add ~/.ssh/id_ed25519`	`ssh-add $env:USERPROFILE\.ssh\id_ed25519`
Ver chave pública	`cat ~/.ssh/id_ed25519.pub`	`Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub`
Testar conexão	`ssh -T git@github.com`	Mesmo comando

11. Usando tokens clássicos (PAT) com GitHub

Desde agosto de 2021, o GitHub não aceita mais senha de conta para autenticação via HTTPS. Agora, você deve usar um Personal Access Token (PAT) em vez da senha ao fazer push, pull ou clonar repositórios privados.

11.1 Criar um Personal Access Token (PAT)

Acesse: https://github.com/settings/tokens
Vá até "Fine-grained tokens" ou "Classic tokens" (neste caso, use os clássicos).
Clique em "Generate new token (classic)"
Preencha:
- Note: nome descritivo (ex: "Token pessoal para meu notebook")
- Expiration: escolha a validade (ex: 90 dias)
- Scopes:
  - Se você vai apenas clonar ou baixar: marque repo:read
  - Para enviar alterações (push), marque repo
Clique em "Generate token"
Copie o token e guarde com segurança. ==Você não poderá vê-lo novamente.==

11.2 Usar o token para autenticar no GitHub via HTTPS

Clonando repositório com HTTPS

git clone https://github.com/usuario/repositorio.git

Quando solicitado:

Username: seu nome de usuário do GitHub
Password: cole o token (não sua senha da conta)

Fazendo push ou pull

Se já tiver o repositório local, ao executar:

git push origin main

O Git pedirá autenticação. Novamente, use seu usuário GitHub e o token no lugar da senha.

11.3 Evitar digitar o token toda vez

Você pode salvar as credenciais localmente.

Linux / Git Bash

git config --global credential.helper cache       # temporário (em memória)
# ou
git config --global credential.helper store       # salva em texto plano (~/.git-credentials)

Windows / PowerShell

git config --global credential.helper manager     # usa o Windows Credential Manager

11.4 Ver ou editar configurações de credenciais

git config --global --edit

Resumo da autenticação com token

Ação	Detalhe / Comando
Criar token	https://github.com/settings/tokens
Usar com clone/push/pull	Usuário: GitHub username Senha: token
Salvar token (Linux)	`git config --global credential.helper store`
Salvar token (Windows)	`git config --global credential.helper manager`

Quando usar token e quando usar SSH?

Caso	Recomenda-se usar...
Trabalho em máquina pessoal segura	SSH
Máquinas temporárias ou públicas	Token (com validade curta)
Integração com CI/CD	Token (ou deploy keys)

andersonbuenos/Nivelamento 4_0 Git e GitHub.md

1. O que é Git e GitHub

2. Instalação do Git

No Windows

No Linux

3. Configuração inicial

4. Criar um repositório Git local

5. Fluxo básico de trabalho com Git

Adicionar arquivos e fazer commit

Ver o status e histórico

6. Conectar ao GitHub

Criar um repositório no GitHub

Conectar seu repositório local ao remoto

7. Clonar um repositório existente

8. Atualizar repositório local com mudanças remotas

9. Subir alterações para o GitHub

Resumo dos comandos principais

10. Usando SSH com o GitHub

10.1 Verificar se você já tem uma chave SSH

10.2 Criar uma nova chave SSH

No Linux ou Git Bash (Windows)

No PowerShell (Windows)

10.3 Adicionar a chave SSH ao agente

Linux / Git Bash

PowerShell

10.4 Adicionar sua chave pública ao GitHub

Linux / Git Bash

PowerShell

10.5 Testar conexão com GitHub

10.6 Usar SSH em vez de HTTPS nos repositórios

Resumo da seção SSH

11. Usando tokens clássicos (PAT) com GitHub

11.1 Criar um Personal Access Token (PAT)

11.2 Usar o token para autenticar no GitHub via HTTPS

Clonando repositório com HTTPS

Fazendo push ou pull

11.3 Evitar digitar o token toda vez

Linux / Git Bash

Windows / PowerShell

11.4 Ver ou editar configurações de credenciais

Resumo da autenticação com token

Quando usar token e quando usar SSH?