Instalando e usando Git e GitHub no Ubuntu Linux: Um guia para iniciantes

GitHub é um tesouro de alguns dos melhores projetos do mundo, construídos pelas contribuições de desenvolvedores de todo o mundo. Esta plataforma fácil de usar e atraente ajuda todos os interessados em construir ou desenvolver algo grande a contribuir e ser reconhecidos na comunidade de código aberto.

Git é um sistema de controle de versão distribuído amplamente utilizado no desenvolvimento de software, particularmente em ambientes Linux. Ele permite que os desenvolvedores rastreiem mudanças em seu código, colaborem com outros e gerenciem diferentes versões de seus projetos. O Git permite a criação de repositórios, onde o código e arquivos relacionados são armazenados, e suporta ramificação e mesclagem, permitindo que os desenvolvedores trabalhem em diferentes recursos ou correções de forma independente antes de integrar suas mudanças. A natureza descentralizada do Git significa que cada colaborador tem uma cópia completa do repositório, garantindo que o trabalho possa continuar mesmo sem acesso à rede. Integrado ao Linux, o Git é frequentemente usado via linha de comando, oferecendo ferramentas poderosas para gerenciamento de código-fonte, tornando-o essencial para os fluxos de trabalho modernos de desenvolvimento de software.

Este tutorial é um guia rápido de configuração para instalar o Git e usar o GitHub. Ele explica como realizar suas várias funções: criar um repositório localmente, conectar esse repositório ao host remoto que contém seu projeto (onde todos podem ver), confirmar as mudanças e, finalmente, enviar todo o conteúdo do sistema local para o GitHub.

Por favor, note que este tutorial assume que você tem um conhecimento básico dos termos usados no Git, como push, pull requests, commit, repositório, etc. Também requer que você se registre no GitHub aqui e anote seu nome de usuário do GitHub. Então, vamos começar:

1 Instalando o Git para Linux

Baixe e instale o Git para Linux:

sudo apt install git

O comando acima é para Ubuntu e funciona em todas as versões recentes do Ubuntu, testadas do Ubuntu 20.04 até Ubuntu 24.04, e é provável que funcione da mesma forma em versões futuras.

2 Configurando o GitHub

Uma vez que a instalação foi concluída com sucesso, a próxima coisa a fazer é configurar os detalhes de configuração do usuário do GitHub. Para fazer isso, use os seguintes dois comandos, substituindo “user_name” pelo seu nome de usuário do GitHub e substituindo “email_id” pelo seu email que você usou para criar sua conta do GitHub.

git config --global user.name "user_name"

git config --global user.email "email_id"

A imagem a seguir mostra um exemplo da minha configuração, com meu “user_name” sendo “akshaypai” e meu “email_id” sendo “ [email protected] “.

3 Criando um repositório local

Crie uma pasta em seu sistema. Esta servirá como um repositório local que será posteriormente enviado para o site do GitHub. Use o seguinte comando:

git init Mytest

Se o repositório for criado com sucesso, você verá a seguinte linha:

Initialized empty Git repository in /home/akshay/Mytest/.git/

Esta linha pode variar dependendo do seu sistema.

Então aqui, Mytest é a pasta que foi criada e “init” torna a pasta um repositório do GitHub. Mude o diretório para esta pasta recém-criada:

cd Mytest

4 Crie um arquivo README para descrever o repositório

Agora crie um arquivo README e insira algum texto como “este é um setup do git no Linux”. O arquivo README é geralmente usado para descrever o que o repositório contém ou sobre o que é o projeto. Exemplo:

gedit README

Você pode usar qualquer outro editor de texto. Eu uso gedit. O conteúdo do arquivo README será:

This is a git repo

5 Adicionando arquivos do repositório a um índice

Este é um passo importante. Aqui adicionamos tudo que precisa ser enviado para o site a um índice. Essas coisas podem ser os arquivos de texto ou programas que você pode adicionar pela primeira vez ao repositório ou pode ser adicionar um arquivo que já existe, mas com algumas mudanças (uma versão mais nova/versão atualizada).

Aqui já temos o arquivo README. Então, vamos criar outro arquivo que contém um programa simples em C e chamá-lo de sample.c. O conteúdo dele será:

#include
int main()
{
printf("hello world");
return 0;
}

Então, agora que temos 2 arquivos

README e sample.c

adicione-os ao índice usando os seguintes 2 comandos:

git add README

git add sample.c

Note que o comando “git add” pode ser usado para adicionar qualquer número de arquivos e pastas ao índice. Aqui, quando digo índice, estou me referindo a um espaço semelhante a um buffer que armazena os arquivos/pastas que devem ser adicionados ao repositório do Git.

6 Confirmando mudanças feitas no índice

Uma vez que todos os arquivos estão adicionados, podemos confirmá-los. Isso significa que finalizamos quais adições e/ou mudanças devem ser feitas e agora estão prontas para serem enviadas ao nosso repositório. Use o comando:

git commit -m "some_message"

“some_message” no comando acima pode ser qualquer mensagem simples como “meu primeiro commit” ou “edição no readme”, etc.

7 Criando um repositório no GitHub

Crie um repositório no GitHub. Note que o nome do repositório deve ser o mesmo que o do repositório no sistema local. Neste caso, será “Mytest”. Para fazer isso, faça login na sua conta em https://github.com. Em seguida, clique no símbolo “mais (+)” no canto superior direito da página e selecione “criar novo repositório”. Preencha os detalhes conforme mostrado na imagem abaixo e clique no botão “criar repositório”.

Criando um repositório no GitHub

Uma vez que isso é criado, podemos enviar o conteúdo do repositório local para o repositório do GitHub em seu perfil. Conecte-se ao repositório no GitHub usando o comando:

Nota Importante: Certifique-se de substituir ‘user_name’ e ‘Mytest’ no caminho pelo seu nome de usuário do Github e pasta antes de executar o comando!

git remote add origin https://github.com/user_name/Mytest.git

8 Enviando arquivos de um repositório local para um repositório GitHub

O passo final é enviar o conteúdo do repositório local para o repositório remoto (GitHub), usando o comando:

git push origin master

Digite as credenciais de login [user_name e senha].

A imagem a seguir mostra o procedimento do passo 5 ao passo 8

Enviando arquivos do repositório local para o repositório GitHub

Assim, isso adiciona todo o conteúdo da pasta ‘Mytest’ (meu repositório local) ao GitHub. Para projetos subsequentes ou para criar repositórios, você pode começar diretamente pelo passo 3. Finalmente, se você fizer login em sua conta do GitHub e clicar em seu repositório Mytest, você pode ver que os 2 arquivos README e sample.c foram enviados e estão visíveis para todos, como mostrado na imagem a seguir.

Conteúdo enviado para o Github

Perguntas Frequentes

Como posso verificar se o Git está instalado corretamente?

Após a instalação, você pode verificar se o Git está instalado digitando:

git --version

no terminal. Isso exibirá a versão instalada do Git.

Como configuro o Git com meu nome de usuário e email?

Configure seu nome de usuário e email do Git usando os comandos:

git config --global user.name "Seu Nome"  
git config --global user.email "[email protected]"

Substitua “Seu Nome” e “ [email protected] “ pelos seus dados pessoais.

Quais são os comandos básicos do Git que devo conhecer?

Os comandos GIT mais frequentemente usados são:

git init: Inicializa um novo repositório Git.
git clone [URL]: Clona um repositório de uma fonte remota.
git add [arquivo]: Adiciona arquivos à área de preparação.
git commit -m “[mensagem de commit]”: Confirma suas mudanças com uma mensagem.
git push: Envia suas mudanças para o repositório remoto.
git pull: Puxa atualizações do repositório remoto.

Como faço para criar um novo repositório no GitHub?

Vá para o GitHub, faça login e clique no ícone “ + “ no canto superior direito. Em seguida, selecione “ Novo repositório.” Preencha os detalhes do repositório e clique em “ Criar repositório.”

Como posso enviar meu repositório local para o GitHub?

Primeiro, adicione o repositório remoto usando:

git remote add origin [URL do repositório]

Em seguida, envie seu código com:

git push -u origin master

(para o primeiro envio) ou

git push

(para envios subsequentes).

O que devo fazer se receber um erro ‘permissão negada’ ao enviar para o GitHub?

Esse erro geralmente ocorre quando as chaves SSH não estão configuradas corretamente. Gere uma chave SSH com:

ssh-keygen

e adicione-a à sua conta do GitHub em “ Configurações “ -> “ Chaves SSH e GPG “.

Como faço para puxar mudanças de um repositório do GitHub?

Use git pull para buscar e mesclar mudanças do repositório remoto para o seu repositório local.

O que é um arquivo .gitignore e como eu o uso?

Um arquivo .gitignore especifica arquivos intencionalmente não rastreados que o Git deve ignorar. Adicione nomes de arquivos ou padrões a este arquivo para excluí-los do rastreamento.

Como posso resolver conflitos de mesclagem no Git?

Quando um conflito de mesclagem ocorre, edite manualmente os arquivos para resolver os conflitos, em seguida, use:

git add [arquivo]

para marcá-los como resolvidos e confirmar as mudanças.

Como organizar o desenvolvimento com vários desenvolvedores

O recurso de ramificação no GIT pode organizar commits e desenvolvimento quando vários desenvolvedores trabalham no mesmo projeto. Veja este guia sobre como criar ramificações no GIT.