Git

O Git é um sistema de controle de versão distribuído. Ele é muito utilizado para controle de versão de código fonte e colaboração em projetos de software.

Instalação

Ubuntu e WSL

Para instalar o Git no Ubuntu, ou no WSL utilizando o Ubuntu como distro, basta executar o comando:

sudo apt install git

Fedora

Para instalar o Git no Fedora, execute o comando:

sudo dnf install git

Windows

O Git é focado em sistemas Unix-like. Para usá-lo no Windows, é necessário instalar uma versão específica chamada Git for Windows (bem auto-descritivo).

Você pode baixar o instalador pelo site oficial. Execute o instalador e siga as instruções.

Tela inicial do instalador do Git para Windows, em que se descreve a licença de uso. — Tela inicial do instalador do Git para Windows.

Quando perguntado sobre o editor de texto padrão, você pode escolher o Visual Studio Code, caso o tenha instalado.

Instalador do Git para Windows, na tela de seleção do editor de texto padrão do Git, em que se escolhe a opção "Visual Studio Code". — Seleção do editor de texto padrão do Git.

Na sessão Adjusting the name of the initial branch in new repositories, você pode escolher o nome da branch padrão. Recomendo selecionar a opção Override the default branch name for new repositories e digitar main, uma vez que este é o padrão adotado pelo GitHub.

Instalador do Git para Windows, na tela de seleção do nome padrão de branch, em que se escolhe o nome "main". — Seleção do nome padrão de branch.

Na seção Adjusting your PATH environment, selecione Git from the command line and also from 3rd-party software.

Instalador do Git para Windows, na tela de seleção da configuração da PATH, em que se escolhe a segunda opção, com o texto supracitado. — Seleção da configuração da PATH.

Na seção Choosing the SSH executable, selecione use external OpenSSH.

Instalador do Git para Windows, na tela de seleção do executável do OpenSSH, em que se escolhe a segunda opção, com o texto supracitado. — Seleção do executável do OpenSSH.

Nas próximas sessões, pode manter as opções padrão, até a Configuring extra options, em que recomendo marcar também a caixa Enable symbolic links.

Instalador do Git para Windows, na tela de seleção das configurações extra, em que se selecionam as duas opções supracitadas. — Seleção das configurações extra.

O Git for Windows configura automaticamente a Path para seu executável.

Para testar se a instalação foi bem-sucedida, feche e abra o PowerShell novamente, então execute o comando:

git --version

Se tudo estiver correto, você verá a versão do Git instalada, como git version 2.47.0.windows.1, por exemplo, ou superior.

Configuração

Após instalar o Git, é necessário definir algumas configurações globais para melhorar a experiência de uso. Esta seção pode ser aplicada para todos os sistemas operacionais apresentados: Ubuntu, Fedora e Windows (PowerShell e WSL).

Nome e e-mail

Para definir o nome e e-mail, execute os comandos abaixo, substituindo os valores entre aspas pelo seu nome e seu e-mail.

git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"

Para verificar se as configurações foram aplicadas corretamente, execute os mesmo comandos, mas sem o conteúdo

Terminal do WSL, em que se executam os comandos para definir o nome de autoria dos commits. — Definição do nome de autoria dos commits.

Editor de texto

Para definir o editor de texto padrão, execute o comando abaixo, substituindo code pelo comando que abre o Visual Studio Code no seu sistema.

git config --global core.editor "code --wait"

Branch padrão

Para definir a branch padrão como main, execute o comando abaixo.

git config --global init.defaultBranch main

Github

O GitHub é uma plataforma de hospedagem de código fonte e colaboração em projetos de software.

Para obter commits de repositórios privados e fazer o envio para eles, é necessário configurar a autenticação do seu terminal.

Instalação do GitHub CLI

Para autenticar o Git com o GitHub, eu recomendo instalar uma ferramenta chamada GitHub CLI. Ele permite fazer login no GitHub e gerenciar repositórios diretamente do terminal.

Você pode conhecer sobre o projeto e aprender os comandos disponíveis pelo site oficial.

A instalação depende do sistema operacional que você está utilizando.

Ubuntu e WSL

Para instalar o GitHub CLI no Ubuntu, ou no WSL utilizando o Ubuntu como distro, vamos seguir a documentação oficial.

Este comando adiciona o repositório do GitHub CLI ao seu sistema, e então instala o pacote.

(type -p wget >/dev/null || (sudo apt update && sudo apt-get install wget -y)) \
&& sudo mkdir -p -m 755 /etc/apt/keyrings \
&& wget -qO- https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
&& sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
&& echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
&& sudo apt update \
&& sudo apt install gh -y

Terminal do WSL, em que se executam os comandos para instalar o GitHub CLI. — Instalação do GitHub CLI no WSL.

Fedora

Para instalar o GitHub CLI no Fedora, vamos seguir a documentação oficial.

Este comando adiciona o repositório do GitHub CLI ao seu sistema, e então instala o pacote.

sudo dnf install 'dnf-command(config-manager)'
sudo dnf config-manager --add-repo https://cli.github.com/packages/rpm/gh-cli.repo
sudo dnf install gh --repo gh-cli

Windows

Para instalar o GitHub CLI no Windows, sem o WSL, vamos seguir a documentação oficial.

Abra o PowerShell e execute o comando abaixo.

winget install --id GitHub.cli

Terminal do PowerShell, em que se executa o comando para instalar o GitHub CLI. — Instalação do GitHub CLI no PowerShell.

Alternativamente, você pode baixar o instalador pelo site oficial.

Feche e abra o PowerShell novamente para que as mudanças sejam aplicadas.

Você pode verificar se a instalação foi bem-sucedida executando o comando gh --version.

Terminal do PowerShell, em que se executa o comando para confirmar a instalação do GitHub CLI. — Confirmação da instalação do GitHub CLI no PowerShell.

Autenticação

Para autenticar o GitHub CLI, execute o seguinte comando.

gh auth login

O GitHub CLI irá apresentar uma série de escolhas para você decidir como deseja se autenticar.

Siga o seguinte passo a passo:

Escolha o método de autenticação. Você deve usar o GitHub.com.
Escolha o protocolo de autenticação. Caso você já tenha definido uma chave SSH no GitHub e saiba o que está fazendo, você pode escolher SSH. Caso contrário, escolha HTTPS.
Quando perguntado sobre autenticar com as credenciais do GitHub, digite Y.
Quando solicitada a forma de log-in, selecione Login with a web browser, e pressione Enter.

O GitHub CLI irá então exibir um código de oito caracteres, e um link para você acessar no seu navegador.

Terminal do WSL, em que se executa o comando para autenticar no GitHub CLI. — Autenticação no terminal do WSL por meio do GitHub CLI.

Copie o link e abra em um navegador em que você já esteja logado no GitHub. Então, selecione sua conta, cole o código de oito caracteres no campo de texto e clique em Continue.

janela do navegador, aberto na página de autenticação por código do GitHub. No campo de texto se digita o código fornecido previamente pelo terminal. — Código de autenticação do GitHub CLI colado no navegador.

No meu caso, o WSL não conseguiu abrir o navegador, então ele exibiu esse pequeno erro, mas foi só copiar o link e abrir no navegador que funcionou.

Terminal do WSl, em que se exibe o resultado da autenticação pelo navegador. — Resultado da autenticação pelo navegador.

Visual Studio Code

Você também pode se autenticar no GitHub pelo Visual Studio Code. Eu recomendo fazer isso como complemento ao GitHub CLI, mas não como substituto.

Selecione o ícone do perfil (o que tem a imagem de uma pessoa) no canto inferior esquerdo, e então clique em Sign in to Sync Settings.

Canto inferior esquerdo do Visual Studio Code, em que se clica no ícone de perfil para abrir o menu de log-in. — Menu de log-in do Visual Studio Code.

Quando perguntado sobre a forma de autenticação, selecione GitHub.

O Visual Studio Code irá abrir uma aba no seu navegador, onde você deve selecionar sua conta e autorizar o acesso.

Janela do navegador, aberta na página de autorização de log-in no GitHub a partir do Visual Studio Code. — Autorização de log-in no GitHub pelo Visual Studio Code.