Passo a passo: Como conectar um repositório Git local ao GitHub

Como conectar um repositório local ao GitHub?

Conectar um repositório local ao GitHub permite armazenar o código na nuvem, facilitando o versionamento e a colaboração entre desenvolvedores. O processo envolve a criação de um repositório remoto e a vinculação dele ao repositório local.

1. Criando um repositório no GitHub

Antes de conectar o repositório local, acesse o GitHub e crie um novo repositório:

• Clique no botão New repository.
• Defina um nome para o repositório.
• Escolha entre público ou privado.
• Não adicione arquivos no momento.
• Clique em Create repository.

2. Iniciando um repositório Git local

Caso ainda não tenha um repositório local, crie um com:

git init

Isso inicializa um repositório Git no diretório atual.

3. Adicionando um repositório remoto

Após criar o repositório no GitHub, copie a URL fornecida e adicione-a ao repositório local com:

git remote add origin https://github.com/seu-usuario/nome-do-repositorio.git

Isso configura o repositório remoto chamado origin, apontando para o repositório do GitHub.

4. Adicionando arquivos e enviando para o GitHub

Se já houver arquivos no repositório local, adicione-os ao versionamento:

git add .
git commit -m "Primeiro commit"

Agora, envie os arquivos para o repositório remoto com:

git push -u origin main

Se estiver usando master em vez de main, troque o nome da branch no comando acima.

Por que conectar um repositório local ao GitHub?

Conectar um repositório local ao GitHub é o primeiro passo para um desenvolvimento mais organizado e colaborativo. Com o código armazenado na nuvem, os desenvolvedores podem acessar versões antigas, colaborar em tempo real e garantir que o projeto esteja seguro contra perdas acidentais.

Além de facilitar o controle de versão, o GitHub oferece recursos como issues, pull requests e integração com ferramentas de CI/CD. Para times que trabalham remotamente, essa conexão é essencial para garantir a produtividade e a eficiência no desenvolvimento de software.

Algumas aplicações:

• Armazenar código na nuvem de forma segura
• Facilitar a colaboração entre desenvolvedores
• Manter um histórico de alterações do projeto
• Permitir o acesso remoto ao código de qualquer lugar
• Utilizar funcionalidades avançadas do GitHub, como pull requests e CI/CD

Dicas para quem está começando

• Antes de adicionar um repositório remoto, verifique se já existe algum configurado com 'git remote -v'.
• Se precisar alterar a URL do repositório remoto, use 'git remote set-url origin nova-url'.
• Se for a primeira vez que usa o GitHub, configure suas credenciais com 'git config --global user.name "Seu Nome"' e 'git config --global user.email "seu@email.com"'.
• Se o push falhar por problemas de autenticação, tente gerar um token de acesso no GitHub.
• Use 'git status' antes de um commit para conferir quais arquivos serão enviados ao repositório remoto.

Contribuições de

Ricardo Moura

Especialista em Git, fluxos de trabalho colaborativos e integração contínua.

Mais sobre o autor

Compartilhe este tutorial