Hackathon de 1 Caractere - Parte I

Olá, nesse post esperamos te ajudar a concluir as etapas necessárias relacionadas ao Git para que consiga participar tranquilamente do restante do Hackathon!

O que é o Git?

O Git é um Software Livre que atua como um Sistema de Controle de Versão, ou seja, é utilizado para realizar a manutenção da distribuição de diversas aplicações! Podemos usar o Git para ir liberando releases de nossa aplicação, anotações, livro, qualquer coisa contributiva, basta criarmos um repositório e disponibilizarmos em uma plataforma como o GitHub ou o GitLab.

Instalando o Git

Seguem abaixo algumas linhas de comando para a instalação do Git em algumas distribuições de Linux.

sudo apt install git            # Debian/Ubuntu
sudo dnf install git-all        # Fedora
sudo pacman -Syu git            # Arch

Criando sua conta!

GitLab

Crie sua conta através deste link

GitHub

Crie sua conta através deste link

Sua primeira contribuição (no Hackathon)

Realizando o Fork

Certifique-se de estar devidamente logado para continuar com as etapas abaixo!

GitLab

Vamos realizar o fork do seguinte repositório.

No canto direito do título do repositório, haverá um botão escrito Fork, clique nele. Ele o redicionará para uma tela onde será possível a alteração de informações, mas nada será alterado. Selecione o seu usuário na sessão “Select a namespace” e o nível de visibilidade como “public”. Prossiga clicando no botão Fork Project. Avance para a próxima sessão.

GitHub

Vamos realizar o fork do seguinte repositório.

No canto direito do título do repositório, haverá um botão escrito “Fork”, clique nele. Em seguida, selecione o botão “Create Fork”. Avance para a próxima sessão.

Clonando o repositório localmente

No seu repositório forkado, selecione o botão “Clone”, isso abrirá um menu com a opção “Clone with HTTPS”, copie o link associado pois iremos utilizá-lo em breve.

Vamos criar um diretório local para armazenarmos o repositório remoto em nossas máquinas para podermos realizar alterações. Para isso, execute as seguintes linhas de comando.

mkdir -p ~/Projects
cd ~/Projects
git clone link first-contribution   # Substitua a palavra-chave link pelo seu próprio
cd first-contribution

Feito isso, podemos avançar para próxima sessão.

Criando e acessando uma branch em seu repositório local

Basta rodarmos a seguinte linha de comando.

git checkout -b add-nome-sobrenome          # A não ser que seu nome seja "nome" e sobrenome seja "sobrenome", altere esses valores!

Configurando coisas importantes do Git

Global Config

Esse tipo de configuração é feito, normalmente, apenas uma vez, a não ser que você tenha alterado algum dado importante seu. Basta seguir rodando as linhas de comando seguintes.

git config --global user.name "Nome Sobrenome"
git config --global user.email "seu.email@email.org"

Personal Access Token (PAT)

Para permitimos o push de commits, precisamos de um Token de Acesso! Para isso, podemos seguir criando eles em suas respectivas plataformas.

GitLab

Clique em seu usuário no GitLab, em seguida, selecione a opção “Preferences”.

Em seguida, no lado esquerdo, selecione a opção “Access Tokens”.

Preencha o campo “Token Name” como quiser, recomendamos utilizar “Hackathon”. Selecione apenas a caixa “api” e continue clicando no botão “Create personal access token”.

O valor do Token de Acesso deverá estar visível, como mostra a figura abaixo.

GitHub

Clique em seu usuário no GitHub, em seguida, selecione a opção “Settings”.

No menu da esquerda, selecione a opção “Developer Settings”, fica lá embaixo!

Agora selecione a opção “Tokens (classic)”. Em seguida, clique em “Generate new token (classic)”.

Em seguida, adicione uma identificação e marque a caixa “repo”. Finalize gerando o novo token.

Certifique-se de salvar o Token gerado! Será importante para terminarmos o que começamos.

Contribuindo!

Agora vamos, finalmente, contribuir para o Fork realizado. Volte para o diretório que criamos anteriormente.

Edite o arquivo Contributors.md, adicionando no meio do arquivo a linha:

Nome Sobrenome

Adicione as mudanças feitas para o stage com a linha de comando

git add -A
git commit -m "Uma mensagem fofa."
git push

Quando solicitado sua autorização, siga os passos caso:

GitLab

Username: oauth2

Senha: token-de-acesso-criado

GitHub

Username: seu-usuario

Senha: token-de-acesso-criado

Criando o Merge Request

Essa etapa será responsável por mesclar o repositório que você fez o Fork com o seu repositório local.

Basta seguirmos os passos ilustrados abaixo.

Para GitLab:

Para GitHub:

Por enquanto é isso! Esperamos você depois do Coffee break!