Guia Completo para Usar Git e GitHub: Crie e Publique Seu Repositório
O que é Git?
O Git é um sistema de controle de versão distribuído, projetado para rastrear alterações em arquivos e facilitar o trabalho em equipe em projetos de software. Ele permite que os desenvolvedores:
- Versionem arquivos: Acompanhem as mudanças ao longo do tempo, permitindo reverter a estados anteriores.
- Trabalhem de forma colaborativa: Equipes podem trabalhar simultaneamente no mesmo projeto sem sobrescrever o trabalho umas das outras.
- Tratem ramificações (branches): Possibilita criar ramificações independentes para desenvolver novos recursos ou corrigir problemas, sem afetar o código principal até que seja necessário.
Criado por Linus Torvalds em 2005, o Git é amplamente utilizado por equipes de desenvolvimento em todo o mundo devido à sua velocidade, eficiência e flexibilidade.
O que é GitHub?
O GitHub é uma plataforma baseada na web que utiliza o Git como base, fornecendo um espaço para armazenar repositórios Git. Além de ser um lugar para hospedar código, ele oferece ferramentas poderosas para colaboração e gerenciamento de projetos.
Principais funcionalidades do GitHub:
- Repositórios remotos: Permite armazenar e compartilhar código na nuvem.
- Colaboração: Desenvolvedores podem contribuir para projetos públicos ou privados usando ferramentas como pull requests e revisões de código.
- Gestão de projetos: Inclui funcionalidades como issues, milestones e boards para acompanhar o progresso do trabalho.
- Integração e automação: Com o GitHub Actions, você pode configurar fluxos de trabalho automatizados para testes, deploys e muito mais.
Por que usar Git e GitHub juntos?
O Git permite gerenciar o histórico do projeto localmente, enquanto o GitHub conecta esse histórico ao mundo, facilitando o compartilhamento e a colaboração. Usando ambos juntos, você obtém o melhor dos dois mundos:
- Controle total sobre seu projeto no seu computador.
- Capacidade de sincronizar, colaborar e compartilhar com equipes ou a comunidade global.
Com essa base, vamos detalhar o processo para criar um repositório local e publicá-lo no GitHub, garantindo que seu projeto esteja pronto para colaboração e crescimento.
Passo a Passo: Configurando Seu Repositório e Publicando no GitHub
1. Inicie seu repositório local
Comece configurando o Git no diretório do seu projeto:
Acesse o diretório local do seu projeto que deseja publicar/criar no GitHub para configurá-lo.
git initO que você está fazendo:
- Criando um repositório Git vazio no diretório atual.
- Um diretório oculto chamado
.gitserá criado, onde o histórico e as configurações do Git serão armazenados.
2. Adicione os arquivos ao controle de versão
Coloque os arquivos do seu projeto no stage (área de preparação):
git add .O que isso faz:
- Inclui todos os arquivos e subdiretórios no stage, indicando que eles estão prontos para serem versionados no próximo commit.
3. Salve a primeira versão do projeto
Agora, registre as alterações com um commit inicial:
git commit -m "Primeiro commit"O que acontece aqui:
- Você salva o estado atual do projeto no histórico do Git.
- A mensagem “Primeiro commit” descreve as alterações realizadas. Use mensagens claras e objetivas para facilitar o entendimento no futuro. A mensagem deve mostrar de forma clara o que foi alterado no projeto.
4. Autentique-se no GitHub
Para conectar seu repositório local ao GitHub, autentique sua conta:
- Use o comando abaixo para iniciar o processo de autenticação:
gh auth login - Siga os passos apresentados no terminal:
- Escolha o GitHub.com como a conta para autenticação (A outra opção é o GitHub Enterprise Server, para contas cooporativas).
- Se solicitado, confirme com
ypara reautenticar. - Escolha o protocolo HTTPS (é mais simples de configurar do que SSH).
- O GitHub CLI abrirá o navegador para login:
- Faça o login com seu usuário no portal do GitHub.
- Um código único será gerado, como
XXXX-XXXX. Copie-o. - Digite o código no site exibido e clique em Authorize GitHub para confirmar.
- Volte ao terminal, onde uma mensagem confirmará que você está autenticado.
5. Crie o repositório remoto no GitHub
Com sua conta autenticada, você pode criar um repositório remoto diretamente pelo terminal:
gh repo create <nome-do-repositorio> --public --source=. --remote=originEntenda o comando:
nome-do-repositorio: Substitua pelo nome desejado para o repositório.--public: Torna o repositório público (qualquer pessoa pode visualizar). Use--privatese deseja que seja privado.--source=.: Indica que o repositório será baseado no diretório atual.--remote=origin: Configura o repositório remoto comoorigin, o padrão para comandospushepull.
Após isso, o repositório será criado no portal do GitHub e vinculado ao seu projeto local.
6. Envie o projeto para o GitHub
Finalmente, envie seu código local para o repositório remoto:
git push -u origin masterO que acontece aqui:
- Envia os commits do branch local
masterpara o repositório remotoorigin. - A flag
-uconfigura o branch local para rastrear o branch remoto correspondente, facilitando operações futuras de sincronização.
7. Ignore arquivos que não devem ser versionados
Antes do primeiro commit (ou a qualquer momento), crie um arquivo .gitignore na raiz do projeto para excluir do controle de versão pastas geradas automaticamente, dependências e arquivos sensíveis:
node_modules/
.env
dist/
*.logSem isso, é comum enviar acidentalmente node_modules/ inteiro (milhares de arquivos) ou um .env com senhas e chaves de API para um repositório público — um erro que, mesmo removido depois, permanece no histórico do Git e exige reescrita do histórico para ser totalmente eliminado. Sempre crie o .gitignore antes do primeiro git add ..
Já Existe um Repositório? Use git clone
O passo a passo acima cobre o cenário de criar um projeto novo do zero. Se você vai apenas trabalhar em um repositório que já existe no GitHub (de um colega, de uma empresa, de um projeto open source), o fluxo é mais direto:
git clone https://github.com/usuario/nome-do-repositorio.gitIsso baixa todo o histórico do projeto para uma pasta local já conectada ao repositório remoto — sem precisar de git init nem gh repo create.
Erros Comuns e Como Resolver
“Updates were rejected because the remote contains work that you do not have locally” Acontece quando alguém mais enviou commits para o mesmo branch remoto depois da sua última sincronização. Resolva trazendo as mudanças antes de enviar as suas:
git pull origin master
git push origin master“fatal: not a git repository”
Você tentou rodar um comando Git fora de uma pasta inicializada com git init (ou clonada com git clone). Confirme com pwd (ou cd no Windows) que está no diretório correto do projeto.
Arquivo grande demais para o GitHub
O GitHub recusa arquivos individuais acima de 100 MB. Isso geralmente indica que algo como um vídeo, banco de dados local ou pasta node_modules/ foi commitado por engano — a correção correta é adicionar o arquivo ao .gitignore e removê-lo do histórico, não apenas apagá-lo na próxima revisão (o arquivo continuaria ocupando espaço no histórico).
Comandos do Dia a Dia (Além da Publicação Inicial)
Depois do repositório publicado, estes são os comandos que você vai usar com mais frequência:
| Comando | Para que serve |
|---|---|
git status | Mostra o que foi modificado, adicionado ou ainda não está sendo rastreado |
git log --oneline | Lista o histórico de commits de forma resumida |
git diff | Mostra exatamente o que mudou em cada arquivo antes de dar add |
git branch nome-da-feature | Cria uma nova ramificação para desenvolver algo sem afetar o master |
git checkout nome-da-feature | Muda para a ramificação criada |
git pull | Baixa e mescla as últimas mudanças do repositório remoto |
Resumo dos Comandos Usados
- Iniciar repositório local:
git init - Adicionar arquivos ao stage:
git add . - Fazer o primeiro commit:
git commit -m "Primeiro commit" - Autenticar no GitHub:
gh auth login - Criar o repositório remoto:
gh repo create nome-do-repositorio --public --source=. --remote=origin - Enviar o projeto para o GitHub:
git push -u origin master
Concluindo
Agora seu projeto está versionado localmente e publicado no GitHub, pronto para colaboração e desenvolvimento contínuo. Você pode adicionar mais commits, criar branches e gerenciar seu código com facilidade, usando os comandos Git e os recursos do GitHub para otimizar seu fluxo de trabalho. 🚀
Comentários
Não foi possível carregar os comentários no momento.
Deixe seu comentário