Repositórios, remotes e login
Crie e clone repositórios, autentique-se com segurança usando chaves SSH ou tokens e configure .gitignore, licença e README.
- Criar um repositório no GitHub e conectá-lo a um repositório local com remotes
- Escolher entre HTTPS com token e chaves SSH, e manter as credenciais seguras
- Configurar os arquivos de que todo repositório precisa: README, .gitignore e LICENSE
Há duas formas de começar:
- GitHub primeiro: clique em New repository e depois faça
git clonedele para a sua máquina. - Local primeiro: você já tem um repositório Git; crie um vazio no GitHub e conecte-o com um remote.
1# 1. GitHub first
2git clone git@github.com:dungeon-dash/dungeon-dash.git
3cd dungeon-dash
4
5# 2. Local first: connect an existing repository, then push
6git remote add origin git@github.com:mira/level-editor.git
7git branch -M main
8git push -u origin main # -u remembers origin/main as the upstream
9
10git remote -v # list remotes and their URLsorigin é só o nome convencional para “a cópia no GitHub”. Depois de push -u, um simples git push ou git pull naquela branch sabe para onde ir.
Provando quem você é
Ler um repositório público não exige login, mas fazer push exige. O GitHub deixou de aceitar senhas de conta para o Git em 2021. Você tem duas boas opções:
| HTTPS + token | Chave SSH | |
|---|---|---|
| A URL tem esta cara | https://github.com/OWNER/REPO.git | git@github.com:OWNER/REPO.git |
| Segredo | um personal access token (tokens fine-grained podem ser limitados a repositórios e permissões específicos) | um arquivo de chave privada que nunca sai da sua máquina |
| Configuração | crie um token e deixe um gerenciador de credenciais (ou gh auth login) guardá-lo | ssh-keygen -t ed25519 e depois adicione a chave pública ao GitHub |
Qualquer uma serve. O que importa: a metade privada de uma chave e todo token são segredos. Nunca faça commit deles, nunca os cole em issues e dê aos tokens só as permissões e a validade de que precisam.
ssh-keygen -t ed25519 -C "mira@example.com" # creates ~/.ssh/id_ed25519 and id_ed25519.pub
cat ~/.ssh/id_ed25519.pub # paste THIS (the .pub) into GitHub → Settings → SSH keys
ssh -T git@github.com # "Hi mira! You've successfully authenticated..."Arquivos de que todo repositório precisa
- README.md - a página de entrada: o que é o projeto, como instalar e usar, como contribuir. O GitHub o renderiza abaixo da lista de arquivos.
- .gitignore - padrões de arquivos que o Git nunca deve rastrear: saída de build, dependências (
node_modules/), configurações do editor e qualquer coisa secreta, como.env. - LICENSE - sem ela, ninguém pode reutilizar legalmente o seu código, mesmo que ele seja público. (Mais na aula de open source.)
1# build output and dependencies
2build/
3node_modules/
4*.pyc
5
6# secrets - never commit these
7.env
8*.pem
9
10# but keep this one example file
11!.env.example
12
13# only the save files in the repository root
14/saves/As regras, simplificadas: um padrão sem barra casa com o nome de um arquivo ou pasta em qualquer lugar; uma / no final casa só com pastas; uma / no começo ancora na raiz do repositório; ! volta a incluir algo que um padrão anterior ignorou; e a última regra que casa vence. O .gitignore só afeta arquivos não rastreados - se um arquivo já foi commitado, ignorá-lo depois não muda nada até você fazer git rm --cached nele.
Principais conclusões
Clone um repositório do GitHub, ou conecte um local com
git remote add origin ...egit push -u.Autentique-se com uma chave SSH ou um token HTTPS - nunca uma senha - e trate os dois como segredos.
Revogue tokens vazados imediatamente; tirá-los do código não basta.
Todo repositório precisa de um README, um .gitignore (a última regra que casa vence) e uma LICENSE.
Quiz da aula
7 perguntas · aprovação com 5 acertos · até 50 XP
Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.
Pratique: automatize tarefas do GitHub com Python
O trabalho real no GitHub envolve muita automação pequena: conferir CODEOWNERS, expandir matrizes de build, atualizar versões, ler a API. Escreva esses utilitários em Python e execute-os com entradas de exemplo, localmente no navegador e sem precisar de conta no GitHub.
Converta URLs de remotes
Um novo contribuidor não consegue fazer push porque clonou com o tipo errado de URL. Cada linha de entrada é to-ssh URL ou to-https URL. Imprima a URL de remote convertida; as duas formas precisam terminar em .git:
https://github.com/dungeon-dash/dungeon-dash.git <-> git@github.com:dungeon-dash/dungeon-dash.gitA URL de entrada pode estar em qualquer uma das formas, com ou sem .git.
- Nas duas direções
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
O Git ignoraria isto?
Implemente um .gitignore simplificado. A entrada tem os padrões, uma linha --- e depois caminhos de arquivos (relativos à raiz do repositório, com separadores /). Para cada caminho, imprima ignored ou kept. Regras:
- Um padrão sem
/(desconsiderando uma no final) casa com o nome do arquivo ou de qualquer pasta do caminho, usando curingas de shell (fnmatch). - Um padrão terminado em
/casa só com pastas. - Um padrão começando com
/é ancorado: ele casa com o caminho a partir da raiz (o começo do caminho). - Um padrão começando com
!volta a incluir o que ele casa. - O último padrão que casa vence; se nada casar, o arquivo é mantido (kept).
- Regras do Dungeon Dash
- A última regra vence
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Dúvidas sobre esta lição
Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.
Carregando publicações…