DEV Community

Cover image for guia de comandos git e github para desenvolvedores iniciantes
tati
tati

Posted on

guia de comandos git e github para desenvolvedores iniciantes

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.
Página do GitHub para fazer o cadastro de uma nova conta

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"
Enter fullscreen mode Exit fullscreen mode

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:
No canto superior esquerdo da página inicial do Github logado, temos um botão verde escrito "New", onde iremos todas as vezes que queremos 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.
Página de criação de repositório
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.
Recorte de uma parte da pasta de arquivos do projeto com a janela do botão direito aberta com as opções e o principal "Git Bash here" sinalizado
Também é possível abrir o Git Bash e caminhar pelos diretórios (pastas) através do comando:

cd "Nome do arquivo"/new-repo
Enter fullscreen mode Exit fullscreen mode

Ao abrir o terminal, podemos dar o comando para iniciar o repositório local:

git init
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

Podemos também adicionar todos os arquivos de uma vez usando o ponto final:

git add .
Enter fullscreen mode Exit fullscreen mode

Então, precisamos comitar esses arquivos:

git commit -m "Descrição do commit"
Enter fullscreen mode Exit fullscreen mode

É 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.
Página inicial de um repositório vazio no GitHub
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
Enter fullscreen mode Exit fullscreen mode

Precisamos falar qual branch o projeto ficará:

git branch -M main
Enter fullscreen mode Exit fullscreen mode

E subir o projeto para o repositório remoto:

git push -u origin main
Enter fullscreen mode Exit fullscreen mode

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.
Página de Manage Access do GitHub para enviar convite para colaboradores
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:
Modal que abre quando clicamos em Invite a Collaborator
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:
Caminho para clonar o repositório remoto
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
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

Quando precisamos sair da branch que estamos para a outra, precisamos informar em qual branch queremos ir:

git checkout nome_da_branch_de_destino
Enter fullscreen mode Exit fullscreen mode

Para termos a certeza de qual branch estamos é só chamá-la.

git branch
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

Então todas as alterações que estão no repositório remoto serão atualizadas localmente. Depois disso podemos dar o:

git push
Enter fullscreen mode Exit fullscreen mode

--
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.

Discussion (0)