Criando seu primeiro repositório no GitHub! Guia completo do início ao push

Nos artigos anteriores, concluímos a criação da conta do GitHub e a instalação do Git, e agora você está finalmente pronto para usar o GitHub a sério. Como primeiro passo, vamos criar um "lar" para guardar seu código, um repositório.

Neste artigo, explicaremos detalhadamente todo o processo, desde o conceito básico de "o que é um repositório?", os passos específicos para criar um repositório no GitHub, até o upload (push) do seu primeiro arquivo do seu computador (ambiente local) para o GitHub, tudo acompanhado dos comandos. Este fluxo de trabalho é uma operação básica que você repetirá muitas vezes no seu futuro como desenvolvedor, então, certifique-se de dominá-lo aqui!

Afinal, o que é um repositório? É um "recipiente" para o seu projeto

Um Repositório (Repository), em sua tradução literal, significa "depósito" ou "local de armazenamento". No mundo da programação, pense nele como um "recipiente" para guardar todos os arquivos relacionados ao seu projeto (HTML, CSS, JavaScript, imagens, etc.) junto com todo o seu histórico de alterações (o registro de commits).

Existem, em geral, dois tipos de repositórios:

• Repositório local: É o repositório criado no seu próprio computador. O trabalho diário é feito aqui.
• Repositório remoto: É o que se cria em um servidor na internet, como o GitHub. Ele funciona como um centro para compartilhar código com os membros da equipe e como um backup do seu código pessoal.

O fluxo de desenvolvimento básico consiste em um ciclo de trabalhar no repositório local, salvar o progresso em pontos chave (fazer commit), e depois enviar essas alterações para o repositório remoto (fazer push).

Passos para criar um repositório remoto no GitHub

Primeiro, vamos criar um repositório remoto no GitHub, que será o local onde guardaremos nosso código. O procedimento é muito simples.

Passo 1: Vá para a página de criação de um novo repositório
Faça login no GitHub e clique no ícone "+" no canto superior direito, ou pressione o botão "New" no lado esquerdo do seu painel de controle.

[Imagem: O botão "New" no painel de controle do GitHub em destaque.]

Passo 2: Preencha as informações do repositório
Aparecerá uma página intitulada "Create a new repository". Preencha as informações necessárias.

[Imagem: O formulário "Create a new repository" com explicações para cada campo.]

• Repository name: O nome do seu repositório. Escolha um nome conciso em inglês que descreva o conteúdo do projeto (ex: `my-portfolio-site`).
• Description: Uma breve descrição do repositório (opcional). Escrever sobre o que é o projeto facilita a consulta posterior.
• Public / Private: Escolha a visibilidade. "Public" se quiser que qualquer pessoa no mundo possa ver, ou "Private" se quiser que apenas você ou as pessoas que você convidar possam ver. Para praticar, "Private" está bom.
• Initialize this repository with:: Você pode escolher quais arquivos incluir automaticamente na criação do repositório.
  • Add a README file: É o arquivo de instruções do projeto. É altamente recomendável marcar esta caixa.
  • Add .gitignore: É um arquivo de configuração para especificar os arquivos que você quer que o Git ignore. Por agora, pode deixar como "None".
  • Choose a license: Escolha uma licença para o código-fonte. Para uso pessoal, não é necessário configurar isso agora.

Passo 3: Crie o repositório
Depois de preencher tudo, clique no botão "Create repository". Com isso, seu novo repositório remoto foi criado no GitHub!

[Imagem: A página principal de um repositório recém-criado e vazio.]

Prepare o projeto em seu PC local e conecte-o ao GitHub

A seguir, vamos preparar um projeto no seu PC (local) e enviar nosso primeiro arquivo para o repositório remoto que acabamos de criar.

Passo 1: Crie uma pasta de projeto no seu PC
Primeiro, crie uma pasta de trabalho em um local de sua preferência no seu PC. Aqui, faremos isso usando o terminal (ou Git Bash, se estiver no Windows).

mkdir my-first-repo

Entre na pasta que você acabou de criar.

cd my-first-repo

Passo 2: Inicialize um repositório Git
Para colocar esta pasta sob o controle do Git, execute o comando de inicialização. Isso criará uma pasta oculta chamada `.git` dentro desta pasta.

git init

Passo 3: Crie um arquivo para enviar
Vamos criar um arquivo HTML simples para testar.

echo "Hello, GitHub!" > index.html

Passo 4: Faça o commit do arquivo (salve-o)
Registre o arquivo criado no Git. Primeiro, com `git add`, selecione o arquivo para salvar (staging).

git add index.html

Depois, com `git commit`, crie um ponto de salvamento.

git commit -m "Adicionar arquivo HTML inicial"

Passo 5: Conecte-se ao repositório remoto
Vincule o repositório local ao repositório remoto que você criou anteriormente no GitHub. Vá para a página do seu repositório no GitHub, clique no botão "Code" e copie a URL do SSH.

[Imagem: Clicando no botão "Code" do GitHub e copiando a URL do SSH.]

git remote add origin git@github.com:seu-nome-de-usuario/my-first-repo.git

Passo 6: Faça push para o GitHub (envie)
Chegamos à etapa final. Envie o commit que você criou localmente para o repositório remoto. Isso é chamado de "push".

git push -u origin main

Verificação: Vamos ver se o arquivo apareceu no GitHub!

Após a conclusão do push, tente recarregar a página do seu repositório no GitHub no navegador. Você deverá ver o arquivo `index.html` que acabou de criar! Se clicar no nome do arquivo, também poderá ver o seu conteúdo.

[Imagem: A página do repositório do GitHub mostrando o arquivo index.html recém-adicionado na lista de arquivos.]

Parabéns! Você acaba de dominar o fluxo de trabalho mais básico e importante: enviar um arquivo local para o GitHub.