Como instalar o GitLab no Ubuntu

O GitLab é uma poderosa plataforma DevOps de código aberto que fornece controlo de versões, integração contínua/entrega contínua (CI/CD) e ferramentas de colaboração. A instalação do GitLab no Ubuntu permite-lhe gerir projectos e colaborar com equipas de forma eficiente. Este guia irá orientá-lo na instalação do GitLab num 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 baixe o script GitLab

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

Este script configura o repositório e permite-lhe instalar o GitLab diretamente a partir da fonte oficial do pacote

4. Instalar o GitLab

Agora, instale o GitLab Community Edition (CE). Substitua https://gitlab.example.com pelo URL desejado para aceder à sua instância do GitLab

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

Este comando instala o GitLab e o configura para usar a URL externa especificada. Se estiver a utilizar um servidor local, pode 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

Uma vez que o GitLab esteja instalado e configurado, você pode acessá-lo através da URL que você especificou (https://gitlab.example.com ou o endereço IP do seu servidor). Quando você acessar o GitLab pela primeira vez, você será solicitado a configurar uma senha de administrador. Depois de definir a senha, é possível fazer login com

Nome de utilizador: root
Senha: (a senha que acabou de definir)

7. Configurar notificações de 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. Gerenciar 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 estado do GitLab
sudo gitlab-ctl status

9. Habilitação de HTTPS (opcional)

Para acesso seguro, é recomendável habilitar o HTTPS. Você pode usar o Let’s Encrypt, um provedor de certificado 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 o seu certificado SSL

10. Configuração básica do GitLab

Após a instalação, configure o GitLab para a 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 fornece uma plataforma poderosa para DevOps, controlo de versões e gestão de projectos. Com o GitLab instalado e a funcionar, pode começar a colaborar em projectos, utilizando as funcionalidades robustas do GitLab para gestão de código e CI/CD.