Configurar o GitLab em um Servidor Linux – Hospede sua própria Plataforma DevOps

Descubra como instalar o GitLab de forma eficiente no Linux para otimizar fluxos DevOps e melhorar o trabalho em equipe → Saiba mais agora

10 de novembro de 20266 min de leitura0 visualizações0 útil

Introdução

O GitLab é uma plataforma DevOps completa que permite que equipes trabalhem juntas no código, automatizem fluxos de trabalho e gerenciem todo o ciclo de desenvolvimento de software de forma eficiente. Neste guia, explicamos como instalar o GitLab em um servidor Linux.

Instalar o GitLab com os Aplicativos com um clique

Você pode instalar o GitLab diretamente pelos Aplicativos com um clique na interface web do VPS. Após configurar os Apps pela primeira vez, abra o catálogo de apps, procure por GitLab e inicie a implantação com suas configurações preferidas de projeto, ambiente e domínio. Assim, você pode implantar e gerenciar o GitLab de forma rápida e amigável, sem configurações manuais via linha de comando, aproveitando a gestão web integrada, suporte a domínios próprios e emissão de SSL onde disponível.

Preparação

Os seguintes requisitos são recomendados pela equipe oficial do GitLab. É altamente aconselhável cumprir essas condições para evitar problemas e inconvenientes futuros.

Hardware

Componentes	Mínimo	Recomendado
CPU	2x 2 GHz	4x 2,6+ GHz
RAM	4 GB	8 GB
Armazenamento	10 GB	50+ GB
Banda larga	100 Mbit/s (Upload & Download)	100 Mbit/s (Upload & Download)

Software

Plataforma	Opções
Sistema Operacional	Ubuntu (20.04, 22.04, 24.04), Debian (10, 11, 12), OpenSUSE (15.5)
Banco de Dados	PostgreSQL 14.9+
Servidor Web	NGINX (incluído com GitLab), Puma 6.4.2+
Outros	Redis 7.x+, Sidekiq 7.3.2+, Prometheus 2.54.1+

Informações

Para as especificações mais recentes e precisas, consulte a documentação oficial de Requisitos de Hardware do GitLab.

Para instalar o GitLab no seu servidor Linux, conecte-se via cliente SSH. Veja nosso guia de Primeiro Acesso (SSH).

Após a conexão, você pode instalar os pacotes necessários para a instalação do GitLab.

Passo 1: Instalar dependências

Primeiro, instale algumas dependências para que o instalador do GitLab funcione. Use os comandos abaixo para instalar os pacotes necessários no seu servidor Linux.

Atualize a lista de pacotes e instale o servidor OpenSSH e os pré-requisitos com o comando abaixo. Isso hospedará a interface web do GitLab.

Code

sudo apt update
sudo apt-get install -y curl openssh-server ca-certificates tzdata perl

Opcionalmente, você pode instalar o Postfix (servidor SMTP) se quiser enviar notificações por e-mail via GitLab.

Se desejar usar notificações por e-mail, instale o Postfix com:

Code

sudo apt-get install -y postfix

Atualize a lista de pacotes e instale o servidor OpenSSH e os pré-requisitos com o comando abaixo. Isso hospedará a interface web do GitLab.

Code

sudo apt update
sudo apt-get install -y curl openssh-server ca-certificates perl

Opcionalmente, você pode instalar o Postfix (servidor SMTP) se quiser enviar notificações por e-mail via GitLab.

Se desejar usar notificações por e-mail, instale o Postfix com:

Code

sudo apt-get install -y postfix

Instale o servidor OpenSSH e os pré-requisitos com o comando abaixo. Isso hospedará a interface web do GitLab.

Code

sudo zypper install curl openssh perl

Certifique-se de que o daemon OpenSSH está ativado:

Code

sudo systemctl status sshd
sudo systemctl enable sshd
sudo systemctl start sshd

Se você usa firewalld, certifique-se de liberar as portas necessárias.

Verifique se o firewalld está ativo com:

bash

sudo systemctl status firewalld

Se estiver, abra as portas padrão (80 e 443):

Code

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld

Opcionalmente, você pode instalar o Postfix (servidor SMTP) se quiser enviar notificações por e-mail via GitLab.

Se desejar usar notificações por e-mail, instale o Postfix com:

Code

sudo zypper install postfix
sudo systemctl enable postfix
sudo systemctl start postfix

Informações

Durante a instalação do Postfix, pode aparecer uma configuração. Escolha "Internet Site" e confirme com Enter. Informe o nome DNS externo do seu servidor Linux como "mail name" e confirme. Se aparecerem outras telas, confirme com Enter para aceitar os valores padrão. Se preferir usar outra solução para envio de e-mails, pule esta etapa e configure um servidor SMTP externo após a instalação do GitLab conforme o guia oficial.

Passo 2: Instalar o GitLab

Depois que todas as dependências estiverem instaladas, você pode instalar o GitLab.

Neste guia, instalamos o GitLab diretamente dos repositórios oficiais de pacotes.

O script abaixo adiciona os repositórios do GitLab ao gerenciador de pacotes apt:

Code

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash

Depois, instale o pacote gitlab-ee:

bash

sudo apt-get install -y gitlab-ee

O script abaixo adiciona os repositórios do GitLab ao gerenciador de pacotes Zypper:

Code

curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash

Depois, instale o pacote gitlab-ee:

bash

sudo zypper install gitlab-ee

Após concluir este processo, o GitLab deve estar pronto para uso no seu servidor Linux. Na próxima seção, você configurará as definições importantes para o funcionamento correto do servidor.

Passo 3: Configurar o GitLab

Para que tudo funcione, você precisa fazer algumas alterações no arquivo de configuração. Abra o arquivo de configuração do GitLab com seu editor de texto preferido. Usaremos o editor nano pré-instalado como exemplo.

Code

sudo nano /etc/gitlab/gitlab.rb

Procure a linha external_url e insira seu domínio ou o endereço IP do seu servidor Linux, caso não queira usar um domínio para o GitLab.

Code

## URL do GitLab
##! URL onde o GitLab estará acessível.
##! Para mais detalhes sobre a configuração do external_url, veja:
##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab
##!
##! Nota: Durante instalações/atualizações, a variável de ambiente
##! EXTERNAL_URL é usada para definir/substituir este valor.
##! Em instâncias AWS EC2, tenta-se obter o hostname/IP público
##! da AWS. Mais informações:
##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html
external_url 'http`s`://`Seu domínio / endereço IPv4 do seu servidor Linux`'

Também recomendamos inserir seu endereço de e-mail na linha letsencrypt['contact_emails']. Assim, o Let's Encrypt pode informar e contatar você sobre certificados SSL automáticos e gratuitos.

Informações

Para um certificado SSL gratuito do Let's Encrypt, você precisa de um domínio. Não é possível solicitar um certificado diretamente para um endereço IP.

Code

################################################################################
# Integração Let's Encrypt
################################################################################
# letsencrypt['enable'] = nil
# letsencrypt['contact_emails'] = [`Seu e-mail aqui`] # Deve ser um array de endereços de e-mail
# letsencrypt['group'] = 'root'
# letsencrypt['key_size'] = 2048
# letsencrypt['owner'] = 'root'
# letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www'
# Veja https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically para mais informações
# letsencrypt['auto_renew'] = true
# letsencrypt['auto_renew_hour'] = 0
# letsencrypt['auto_renew_minute'] = nil # Deve ser um número ou expressão cron, se definido.
# letsencrypt['auto_renew_day_of_month'] = "*/4"
# letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt'
# letsencrypt['alt_names'] = []

Dica

Você pode pressionar CTRL+W para buscar letsencrypt['contact_emails'] e pressionar Enter para não precisar procurar manualmente o arquivo todo.

Quando terminar, pressione CTRL+X, depois Y e Enter para salvar as alterações.

Por fim, execute o comando abaixo para reconfigurar o GitLab com as novas definições:

Code

sudo gitlab-ctl reconfigure

Esse processo pode levar algum tempo, pois o GitLab será inicializado com as configurações atualizadas. Se um domínio foi usado, os certificados SSL serão emitidos automaticamente.

Passo 4: Acessar a interface web

Após a inicialização, o servidor deve estar acessível via navegador. Acesse sua página digitando seu domínio ou endereço IP:

Code

https://[seu_dominio] OU http://[seu_endereco_ip]

Na primeira vez, a página de login aparecerá.

Para o primeiro login, use o usuário root.

A senha está em um arquivo no seu servidor Linux. Abra o arquivo com o comando abaixo e procure o campo Password:

Code

sudo nano /etc/gitlab/initial_root_password

Code

# AVISO: Este valor é válido apenas nas seguintes condições

# 1. Se foi definido manualmente (via variável de ambiente `GITLAB_ROOT_PASSWORD` ou configuração `gitlab_rails['initial_root_password']` no `gitlab.rb` antes da primeira carga do banco de dados).

# 2. A senha não foi alterada manualmente, nem via interface nem linha de comando.

#

# Se a senha exibida aqui não funcionar, você deve redefinir a senha do administrador: https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password.

Password: `[SUA_SENHA_AQUI]`

# NOTA: Este arquivo é apagado automaticamente após 24 horas da primeira reconfiguração.

Digite o nome de usuário e senha na página de login para acessar seu painel GitLab pela primeira vez. Agora você deve ter acesso ao seu painel GitLab no seu próprio servidor Linux.

Recomendamos fortemente criar um novo usuário e/ou alterar a senha do usuário root. Você pode fazer isso em Admin no canto inferior esquerdo, depois em Visão geral -> Usuários. Lá você pode gerenciar todos os usuários da sua instância GitLab.

Opcional: Configurar firewall com ufw

Você pode pular esta etapa se não quiser configurar firewall ou se já usa firewalld no OpenSUSE. Certifique-se de que as portas 80/443 e 22 estejam liberadas.

Instalar ufw

Se o ufw já estiver instalado, pule esta etapa.

bash

sudo apt-get install -y ufw

bash

sudo zypper install ufw

Abrir portas necessárias

Code

sudo ufw allow http
sudo ufw allow https
sudo ufw allow OpenSSH

Ativar firewall

Atenção

Por padrão, o ufw bloqueia todas as outras portas além das liberadas. Verifique sua lista branca antes de ativar.

Ative o firewall com:

Code

sudo ufw enable

Conclusão

Parabéns, você instalou o GitLab com sucesso! Se tiver dúvidas ou problemas, nossa equipe de suporte está disponível diariamente para ajudar.

Se quiser fazer mais configurações, recomendamos ler a documentação oficial do GitLab para os próximos passos.

FAQ

Perguntas frequentes

Você pode instalar o GitLab diretamente pelos Aplicativos com um clique na interface web, buscando por GitLab no catálogo de apps e iniciando a implantação com suas configurações preferidas de projeto, ambiente e domínio.

O mínimo é CPU 2x 2 GHz, 4 GB de RAM, 10 GB de armazenamento e 100 Mbit/s de banda (upload e download). Recomendado é CPU 4x 2,6+ GHz, 8 GB de RAM e 50+ GB de armazenamento.

O GitLab é uma plataforma DevOps completa que permite equipes colaborarem no código, automatizarem fluxos de trabalho e gerenciarem todo o ciclo de desenvolvimento de software com eficiência.

Feedback

Este artigo foi útil?

Sua opinião nos ajuda a definir prioridades e a melhorar os conteúdos.

0 de 0 As avaliações consideraram este artigo útil.

Ajuda personalizada

As instruções não são suficientes?

A nossa equipe de suporte da ZAP conhece seu produto — descreva brevemente seu problema e ajudaremos pessoalmente.

## URL do GitLab ##! URL onde o GitLab estará acessível. ##! Para mais detalhes sobre a configuração do external_url, veja: ##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab ##! ##! Nota: Durante instalações/atualizações, a variável de ambiente ##! EXTERNAL_URL é usada para definir/substituir este valor. ##! Em instâncias AWS EC2, tenta-se obter o hostname/IP público ##! da AWS. Mais informações: ##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html external_url 'http`s`://`Seu domínio / endereço IPv4 do seu servidor Linux`'

################################################################################ # Integração Let's Encrypt ################################################################################ # letsencrypt['enable'] = nil # letsencrypt['contact_emails'] = [`Seu e-mail aqui`] # Deve ser um array de endereços de e-mail # letsencrypt['group'] = 'root' # letsencrypt['key_size'] = 2048 # letsencrypt['owner'] = 'root' # letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www' # Veja https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically para mais informações # letsencrypt['auto_renew'] = true # letsencrypt['auto_renew_hour'] = 0 # letsencrypt['auto_renew_minute'] = nil # Deve ser um número ou expressão cron, se definido. # letsencrypt['auto_renew_day_of_month'] = "*/4" # letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt' # letsencrypt['alt_names'] = []

Quais 🍪 cookies você aceita?

Configurar o GitLab em um Servidor Linux – Hospede sua própria Plataforma DevOps

Introdução

Instalar o GitLab com os Aplicativos com um clique

Preparação

Hardware

Software

Passo 1: Instalar dependências

Passo 2: Instalar o GitLab

Passo 3: Configurar o GitLab

Passo 4: Acessar a interface web

Opcional: Configurar firewall com ufw

Instalar ufw

Abrir portas necessárias

Ativar firewall

Conclusão

Perguntas frequentes

Software

Instalar o GitLab com os Aplicativos com um clique

Passo 1: Instalar dependências

Passo 2: Instalar o GitLab

Passo 3: Configurar o GitLab

Passo 4: Acessar a interface web

Opcional: Configurar firewall com ufw

Instalar ufw

Abrir portas necessárias

Ativar firewall

Conclusão

Servidor de jogos

Servidores e hospedagem

ZAPX

Recursos

ZAP-Hosting