Guia Completo para Usar Git e GitHub: Crie e Publique Seu Repositório

Introdução ao Git e ao GitHub

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 init

O que você está fazendo:

• Criando um repositório Git vazio no diretório atual.
• Um diretório oculto chamado .git será 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:

1. Use o comando abaixo para iniciar o processo de autenticação:gh auth login
2. 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 y para reautenticar.
   • Escolha o protocolo HTTPS (é mais simples de configurar do que SSH).
3. 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.
4. 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=origin

Entenda 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 --private se deseja que seja privado.
• --source=.: Indica que o repositório será baseado no diretório atual.
• --remote=origin: Configura o repositório remoto como origin, o padrão para comandos push e pull.

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 master

O que acontece aqui:

• Envia os commits do branch local master para o repositório remoto origin.
• A flag -u configura o branch local para rastrear o branch remoto correspondente, facilitando operações futuras de sincronização.

Resumo dos Comandos Usados

1. Iniciar repositório local:git init
2. Adicionar arquivos ao stage:git add .
3. Fazer o primeiro commit:git commit -m "Primeiro commit"
4. Autenticar no GitHub:gh auth login
5. Criar o repositório remoto:gh repo create nome-do-repositorio --public --source=. --remote=origin
6. 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. 🚀