O GitLab é uma plataforma de DevOps completa que permite o gerenciamento de repositórios Git, CI/CD, monitoramento e muito mais. Neste tutorial, você aprenderá a instalar o GitLab em um contêiner Docker no Ubuntu 22.04.
Requisitos
- Servidor rodando Ubuntu 22.04
- Usuário com privilégios sudo
- Docker e Docker Compose instalados
Passo 1: Atualizar o Sistema
Como primeiro passo, certifique-se de que seu sistema está atualizado. Execute os seguintes comandos para atualizar todos os pacotes:
sudo apt update && sudo apt upgrade -y
Passo 2: Instalar o Docker
Se o Docker não estiver instalado, você pode instalá-lo com os comandos a seguir:
sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io -y
Verifique se o Docker foi instalado corretamente:
sudo docker --version
Passo 3: Instalar o Docker Compose
Agora, instale o Docker Compose, que é necessário para configurar e gerenciar o GitLab:
sudo apt install docker-compose -y
Passo 4: Configurar o GitLab com Docker
Crie um diretório para armazenar os arquivos de configuração do GitLab:
mkdir ~/gitlab
cd ~/gitlab
Em seguida, crie um arquivo docker-compose.yml com a seguinte configuração:
sudo nano docker-compose.yml
Adicione o seguinte conteúdo ao arquivo docker-compose.yml:
version: '3.7'
services:
gitlab:
image: 'gitlab/gitlab-ee:latest'
container_name: gitlab
restart: always
hostname: 'seu-dominio.com'
environment:
GITLAB_OMNIBUS_CONFIG: |
external_url 'http://seu-dominio.com'
ports:
- '80:80'
- '443:443'
- '22:22'
volumes:
- './config:/etc/gitlab'
- './logs:/var/log/gitlab'
- './data:/var/opt/gitlab'
Certifique-se de substituir seu-dominio.com pelo seu domínio real ou pelo endereço IP do servidor.
Passo 5: Iniciar o GitLab com Docker
Agora que o arquivo docker-compose.yml está configurado, execute o Docker Compose para iniciar o GitLab:
sudo docker-compose up -d
Isso iniciará o GitLab em contêineres Docker. Você pode verificar se o contêiner GitLab está rodando com o seguinte comando:
sudo docker ps
Passo 6: Acessar o GitLab
Depois que o GitLab estiver em execução, você pode acessá-lo através do seu navegador. Vá para http://seu-dominio.com ou o endereço IP do servidor. A página de login do GitLab será exibida.
A senha root padrão será gerada automaticamente. Para obter a senha, execute o seguinte comando:
sudo docker exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password
Passo 7: Configurar SSL com Let’s Encrypt (Opcional)
Se você deseja adicionar suporte SSL ao GitLab usando o Let’s Encrypt, basta modificar o arquivo docker-compose.yml para habilitar o SSL:
environment:
GITLAB_OMNIBUS_CONFIG: |
external_url 'https://seu-dominio.com'
letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['[email protected]']
letsencrypt['auto_renew'] = true
Após fazer essa alteração, reinicie os contêineres:
sudo docker-compose down
sudo docker-compose up -d
Servidor VPS
Se precisar de um servidor VPS confiável para hospedar seu GitLab com Docker, veja as opções disponíveis aqui.