Compreender as funcionalidades do GitHub e comandos git irá facilitar muito a vida de desenvolvedores, principalmente aqueles que estão iniciando. Este guia tem como objetivo fazer um passo a passo dos comandos necessário para a criação de um repositório, manutenção do mesmo e também do compartilhamento para trabalhos em equipe.
Definições
- Git: Sistema de controle de versões. Permite a criação de um repositório para guarda de versões de um projeto para controle de equipe. O controle de versões nos ajudam a manter um histórico de alterações e a ter controle sobre cada alteração no código.
- GitHub: Plataforma de hospedagem de código fonte e arquivos de controle de versão criados pelo Git. Permite que desenvolvedores contribuem para projetos privados e Open Source.
Configurações do ambiente
1. Criando uma conta no GitHub
No site do GitHub é possível criar uma conta, definindo login e uma senha para armazenarmos nossos projetos.
2. Configurando o Git
Depois de criarmos a nossa conta no Github, é necessário fazer o download do Git através deste link aqui.
Depois de instalado, precisamos configurar o Git para que os commits feitos de um projeto sejam direcionados para o autor correto. Para isso, no terminal, inserimos os seguintes comandos:
git config --local user.name "seu usuário aqui"
git config --local user.email "seu@email.aqui"
Criando um repositório remoto
Ao acessar a página inicial do seu Github, temos um botão verde no canto esquerdo da tela para criar um novo repositório:
Devemos então criar um nome para o nosso repositório, lembrando de não usar espaço ou acentos gráficos no nome. Podemos decidir se queremos que o nosso repositório seja público ou privado para outros usuários verem.
Quando todos os campos estiverem preenchidos, podemos criar o nosso repositório clicando no botão "Create repository".
Iniciando um repositório local
O primeiro passo é identificar a pasta do nosso projeto em nosso computador. Depois de entrar na pasta, ao clicar com o botão direito, devemos escolher a opção "Git Bash here" para que o terminal seja aberto no caminho até a nossa pasta.
Também é possível abrir o Git Bash e caminhar pelos diretórios (pastas) através do comando:
cd "Nome do arquivo"/new-repo
Ao abrir o terminal, podemos dar o comando para iniciar o repositório local:
git init
Uma vez com o repositório iniciado, podemos comitar o nosso projeto e deixá-lo pronto subi-lo para o GitHub. O primeiro passo é adicioná-lo:
git add nome_do_arquivo
Podemos também adicionar todos os arquivos de uma vez usando o ponto final:
git add .
Então, precisamos comitar esses arquivos:
git commit -m "Descrição do commit"
É importante sempre descrever os seus commits, pois quando for necessário buscar alguma alteração podemos facilmente identificar através da mensagem. Tente criar um padrão para o tipo de commit que fizer ou então seguir alguma convenção (temos o exemplo desse repositório).
Conectando o local com o remoto
Para conectar o nosso repositório local com o remoto e podermos subir nosso projeto para o GitHub, precisamos enviar no terminal uma série de comandos.
Ao criar um repositório no GitHub, o próprio site nos informa quais comandos necessários e podemos copiar e colar no terminal, que ele rodará ao apertar o enter.
Quando já criamos o nosso repositório local e fizemos o primeiro commit, vamos copiar os comandos da segunda parte das instruções. Primeiro temos que adicionar o caminho remoto para o nosso repositório:
git remote add origin caminho_do_github
Precisamos falar qual branch o projeto ficará:
git branch -M main
E subir o projeto para o repositório remoto:
git push -u origin main
Depois de fazer esse comando pela primeira vez no projeto, os próximos commits pode ser levado para o repositório remoto com apenas um git push.
Pronto! O seu projeto já está no GitHub!
Colaborando em repositórios de equipe
Para permitir que outras pessoas tenham acesso para colaborar no seu repositório é preciso enviar um convite para ela no GitHub, dessa forma a pessoa pode comitar e subir alterações sem a sua permissão todas as vezes.
Dentro do repositório, vá em Settings > Manage Access. Lembrando que o seu repositório precisa estar público.
Ao clicar em Invite a Collaborator conseguimos pesquisar o nome de usuário do GitHub da pessoa que queremos convidar para colaborar e então enviar o convite para ela:
Ao recebermos o convite para colaborar no projeto de alguém e aceitamos, precisamos ter esse projeto localmente para fazermos as modificações. Para isso, clicamos no botão Code na página do repositório remoto e copiamos o link do HTTPS que ele nos disponibiliza:
E agora, no terminal, damos um comando para clonar o projeto na nossa máquina, passando o caminho que copiamos do GitHub:
git clone caminho_do_github
Pronto! Agora temos o projeto na nossa máquina e acesso para alterá-lo e subir no repositório remoto!
Comandos importantes para colaboração de projeto
Quando trabalhamos em equipe em um projeto remotamente, precisamos respeitar a colaboração de cada um. Para isso existe uma série de boas práticas para que não quebremos o nosso código durante o processo de construção.
Uma dessas boas práticas é a criação de uma nova branch diferente da main para que cada integrante consiga fazer sua parte sem atrapalhar as alterações dos outros membros. Para criar uma nova branch damos o comando:
git branch nome_da_branch
Quando precisamos sair da branch que estamos para a outra, precisamos informar em qual branch queremos ir:
git checkout nome_da_branch_de_destino
Para termos a certeza de qual branch estamos é só chamá-la.
git branch
Esse comando também nos traz uma lista de branches do projeto, porém a branch que estamos será destacada. Quando quisermos unir duas branches podemos dar o comando:
git merge nome_da_branch
Também como boa prática, precisamos puxar qualquer alteração feita na main antes de subirmos as nossas alterações. Para isso, antes de dar um push precisamos dar o comando:
git pull
Então todas as alterações que estão no repositório remoto serão atualizadas localmente. Depois disso podemos dar o:
git push
--
Com esses comandos básicos conseguimos criar e alterar nossos repositórios de uma forma que criamos um fluxo de trabalho, que vai nos ajudar a manter um registro desses progressos. Com o tempo vamos aprendendo também novos comandos no terminal que irão facilitar o nosso trabalho no dia a dia.
Top comments (0)