Tutorial Completo

Configurando o GitLab do Inteli

Guia detalhado para Windows, Mac e Linux.

Assistir Tutorial em Vídeo Abrir no YouTube

O GitLab é a ferramenta oficial de versionamento de código do Inteli. Este guia cobre desde a instalação até o seu primeiro commit.

1 Acesso ao Portal

Antes de tudo, garanta seu acesso ao sistema:

  1. Acesse: https://git.inteli.edu.br/
  2. Clique no botão de SSO ou login com Google.
  3. Importante: Use seu e-mail @edu.inteli.br.

Quando você for incluído em um repositório/grupo, o GitLab envia um e-mail de confirmação. Esse e-mail indica que o acesso foi concedido e serve como referência para saber que está tudo certo.

E-mail do GitLab confirmando acesso a um grupo/repositório.
Exemplo do e-mail recebido após ser adicionado a um grupo no GitLab.

2 Instalação do Git

Verifique se você tem o Git instalado. Se não tiver, siga os passos abaixo:

Para Windows, utilizaremos o Git Bash, um terminal que simula comandos Unix (Linux) e facilita muito o trabalho.

  1. Acesse git-scm.com/download/win.
  2. Clique em "Click here to download" para baixar o instalador.
  3. Execute o arquivo (Git-....exe).
  4. Instalação: Pode clicar em "Next" em todas as telas. As opções padrão já incluem o Git Bash.
  5. Ao finalizar, abra o menu Iniciar e digite "Git Bash".
  6. Clique para abrir. Uma tela preta (terminal) irá aparecer. É aqui que digitaremos os comandos.

O jeito mais fácil é instalar via terminal. Abra o Terminal (Cmd + Espaço → Digite "Terminal") e rode:

git --version

Se não estiver instalado, o Mac irá perguntar se deseja instalar as ferramentas de desenvolvedor. Clique em Instalar.

Abra seu terminal preferido e instale usando o gerenciador de pacotes da sua distribuição:

Ubuntu / Debian / Mint / Pop!_OS:

sudo apt update && sudo apt install git -y

Fedora:

sudo dnf install git -y

Arch Linux:

sudo pacman -S git

3 Criando e Clonando seu Repositório

Agora vamos criar o seu próprio repositório no GitLab e baixá-lo para sua máquina.

1. Criar um Private Access Token (PAT)

Para interagir com o GitLab (clonar, enviar código), você precisa de uma chave de acesso:

  1. No GitLab, clique no seu avatar (canto superior direito) e vá em Edit Profile ou Settings.
  2. No menu lateral esquerdo, procure por Access Tokens.
  3. Clique em Add new token.
  4. Dê um nome (ex: "Notebook Pessoal").
  5. Selecione uma data de expiração distante ou deixe em branco (se permitido).
  6. Em Select scopes, marque pelo menos: read_repository, write_repository e api.
  7. Clique em Create personal access token.
  8. COPIE O CÓDIGO GERADO IMEDIATAMENTE! Você não poderá vê-lo novamente. Guarde-o em um local seguro temporariamente.

2. Criar um Novo Projeto (Repositório)

Vamos criar o espaço onde seus arquivos ficarão salvos:

  1. Na página inicial do GitLab, clique no botão New project (ou no símbolo de + na barra superior > New project/repository).
  2. Selecione a opção Create blank project.
  3. Project name: Dê um nome ao seu projeto (ex: meu-primeiro-repo).
  4. Visibility Level: Mantenha como Private (só você vê) ou Internal (quem tem login no Inteli vê). Evite Public por enquanto.
  5. Marque a caixinha Initialize repository with a README (isso facilita muito!).
  6. Clique em Create project.

3. Clonar o Projeto

Agora vamos trazer esse repositório para o seu computador.

Obter a URL do Clone:

  1. Dentro do seu novo projeto, clique no botão azul Code (no canto direito).
  2. Em "Clone with HTTPS", clique no ícone de copiar ao lado da URL.

No Terminal ou Git Bash:

# 1. Vá para a área de trabalho (ou onde deseja salvar)
cd Desktop

# 2. Clone o repositório (Cole a URL que você copiou)
# O comando será algo parecido com:
git clone https://git.inteli.edu.br/seu.usuario/meu-primeiro-repo.git

O terminal pedirá suas credenciais:

Dica: Ao digitar a senha/PAT no terminal, nada aparecerá na tela (nem asteriscos). Isso é normal, apenas digite (ou cole) e aperte Enter.

Se tudo der certo, uma nova pasta será criada com o nome do seu projeto.

# Entre na pasta do projeto
cd meu-primeiro-repo

No Windows e no macOS, o PAT costuma ficar salvo (Git Credential Manager / Keychain), então você não precisa fazer login toda hora. No Ubuntu, por padrão ele não fica salvo; para manter autenticado, é preciso configurar um credential helper.

Ubuntu: habilitar credential helper (clique para ver)

1) Instale o helper:

sudo apt update && sudo apt install libsecret-1-0 libsecret-1-dev -y

2) Ative no Git:

git config --global credential.helper /usr/lib/git-core/git-credential-libsecret

Depois do primeiro login com PAT, ele fica armazenado.

Hora de praticar! Agora que você já tem a pasta do projeto, crie um arquivo de texto qualquer dentro dela (ex: ola.txt), escreva algo, e salve. Depois, siga os passos abaixo para enviar essa mudança para o GitLab.

4 Dia a Dia (Commit e Push)

Sempre que fizer alterações nos arquivos:

1. Verificar o que mudou
git status
2. Adicionar as mudanças
git add .
3. Salvar (Commit)
git commit -m "Ex: Finalizei a tela de login"
4. Enviar (Push)
git push origin main
Nota: o nome do branch final pode ser 'main' ou 'master', verifique com git branch.