Carregando
0x10Lição 2 de 14

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.

24 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • 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:

  1. GitHub primeiro: clique em New repository e depois faça git clone dele para a sua máquina.
  2. Local primeiro: você já tem um repositório Git; crie um vazio no GitHub e conecte-o com um remote.
two ways to start
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 URLs

origin é 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 + tokenChave SSH
A URL tem esta carahttps://github.com/OWNER/REPO.gitgit@github.com:OWNER/REPO.git
Segredoum 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çãocrie um token e deixe um gerenciador de credenciais (ou gh auth login) guardá-lossh-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.

set up an SSH key
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.)
.gitignore
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 ... e git 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.

Exercício 1

Converta URLs de remotes

+25 XP

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.git

A URL de entrada pode estar em qualquer uma das formas, com ou sem .git.

  • Nas duas direções
main.py
Carregando editor…

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.

Exercício 2

O Git ignoraria isto?

+25 XP

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
main.py
Carregando editor…

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…