04.12.2024

Como instalar o GitLab no Ubuntu

O GitLab é uma poderosa plataforma de DevOps de código aberto que oferece controle de versão, integração contínua/entrega contínua (CI/CD) e ferramentas de colaboração. A instalação do GitLab no Ubuntu permite gerenciar projetos e colaborar com as equipes de forma eficiente. Este guia o orientará na instalação do GitLab em um servidor Ubuntu.

1. Atualizar os pacotes do sistema

Antes de iniciar a instalação, verifique se os pacotes do sistema estão atualizados:

sudo apt update && sudo apt upgrade -y

2. Instalar as dependências necessárias

O GitLab requer alguns pacotes adicionais para funcionar corretamente. Instale-os executando:

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

3. Adicionar o repositório do GitLab

O GitLab oferece um repositório oficial que simplifica o processo de instalação. Para adicioná-lo, primeiro faça o download do script do GitLab:

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

Esse script configura o repositório e permite que você instale o GitLab diretamente da fonte oficial do pacote.

4. Instalar o GitLab

Agora, instale o GitLab Community Edition (CE). Substitua https://gitlab.example.com pela URL desejada para acessar sua instância do GitLab.

sudo EXTERNAL_URL=”https://gitlab.example.com” apt install gitlab-ce

Esse comando instala o GitLab e o configura para usar a URL externa especificada. Se estiver usando um servidor local, poderá substituir o endereço IP do seu servidor.

5. Configurar o GitLab

Após a instalação, configure o GitLab usando o seguinte comando:

sudo gitlab-ctl reconfigure

Esse comando configura o GitLab com as configurações padrão e gera todos os componentes necessários, como bancos de dados e serviços.

6. Acessar o GitLab em um navegador da Web

Depois que o GitLab estiver instalado e configurado, você poderá acessá-lo por meio da URL especificada (https://gitlab.example.com ou o endereço IP do seu servidor).

Ao acessar o GitLab pela primeira vez, você será solicitado a definir uma senha de administrador. Depois de definir a senha, você pode fazer login com:

Nome de usuário: root
Senha: (a senha que você acabou de definir)

7. Configuração das notificações por e-mail do GitLab (opcional)

Se você quiser que o GitLab envie notificações por e-mail, defina as configurações de e-mail no arquivo de configuração do GitLab localizado em /etc/gitlab/gitlab.rb.

Exemplo de configuração de e-mail:

gitlab_rails[‘smtp_enable’] = true gitlab_rails[‘smtp_address’] = “smtp.yourmailprovider.com” gitlab_rails[‘smtp_port’] = 587 gitlab_rails[‘smtp_user_name’] = “your_email@example.com” gitlab_rails[‘smtp_password’] = “your_email_password” gitlab_rails[‘smtp_domain’] = “example.com” gitlab_rails[‘smtp_authentication’] = “login” gitlab_rails[‘smtp_enable_starttls_auto’] = true

Depois de modificar o arquivo de configuração, reconfigure o GitLab para aplicar as alterações:

sudo gitlab-ctl reconfigure

8. Gerenciando os serviços do GitLab

O GitLab fornece vários comandos para gerenciar seus serviços:

Iniciar o GitLab:
sudo gitlab-ctl start
Parar o GitLab:
sudo gitlab-ctl stop
Reiniciar o GitLab:
sudo gitlab-ctl restart
Verificar o status do GitLab:
sudo gitlab-ctl status

9. Habilitação de HTTPS (opcional)

Para obter acesso seguro, é recomendável ativar o HTTPS. Você pode usar o Let’s Encrypt, um provedor de certificados SSL gratuito, modificando o arquivo /etc/gitlab/gitlab.rb.

Adicione a seguinte configuração:

letsencrypt[‘enable’] = true letsencrypt[‘contact_emails’] = [‘you@example.com’] letsencrypt[‘auto_renew’] = true

Execute o comando de reconfiguração depois de salvar as alterações:

sudo gitlab-ctl reconfigure

Essa configuração habilita o HTTPS com renovação automática para seu certificado SSL.

10. Configuração básica do GitLab

Após a instalação, configure o GitLab para sua organização, definindo grupos, projetos e pipelines de CI/CD, conforme necessário. O GitLab oferece uma interface web intuitiva para gerenciar usuários, criar repositórios e definir permissões.

Conclusão

A instalação do GitLab no Ubuntu é simples e oferece uma plataforma poderosa para DevOps, controle de versão e gerenciamento de projetos. Com o GitLab instalado e funcionando, você pode começar a colaborar em projetos, usando os recursos robustos do GitLab para gerenciamento de código e CI/CD.