Apresentação de GitLab
O GitLab é uma plataforma DevOps que reúne numa única aplicação a hospedagem de repositórios Git, os merge requests, o acompanhamento de issues, o registo de pacotes e a integração contínua (CI/CD). A edição Community (CE) é open source. Serve equipas de desenvolvimento, agências e pequenas empresas que querem manter o código e os pipelines num servidor sob o seu controlo.
Na entrega, o VPS Linux (Debian 12 ou 13, Ubuntu 20.04, 22.04 ou 24.04) já tem o GitLab CE instalado a partir do repositório oficial packages.gitlab.com, através do pacote Omnibus. Um certificado TLS autoassinado, válido por 10 anos, é gerado para o endereço IP público do servidor. O URL externo fica configurado como https://SERVER_IP e o HTTP é redirecionado para HTTPS.
A conta de administração é root. A senha inicial está em /etc/gitlab/initial_root_password. A receita exige pelo menos 4 GB de RAM (8 GB recomendados) e 2 núcleos de CPU: o GitLab consome bastante, por isso dimensione o VPS em conformidade.
O que pode fazer com GitLab
Instalação Omnibus oficial
O GitLab CE é instalado a partir do repositório apt do GitLab e configurado com
gitlab-ctl reconfigure. As atualizações passam depois pelo apt.HTTPS desde a entrega
Um certificado autoassinado RSA 2048 é criado em
/etc/gitlab/ssl/para o IP do servidor. O Nginx redireciona o HTTP para HTTPS.Senha root gerada
A senha inicial da conta
rootfica guardada em/etc/gitlab/initial_root_password, sem qualquer valor predefinido conhecido.Repositórios, revisões e CI/CD
Merge requests, issues, wikis, registo de pacotes e pipelines de CI/CD estão disponíveis na mesma interface, sem ferramentas de terceiros para integrar.
Configuração num único ficheiro
Todos os ajustes passam por
/etc/gitlab/gitlab.rb, seguidos degitlab-ctl reconfigure. É simples de versionar e de reproduzir.
Começar com GitLab
Da encomenda à produção em poucos minutos.
- 1
Encomende o VPS com GitLab
Escolha um [VPS Linux](/vps-linux) em Paris ou Frankfurt com pelo menos 4 GB de RAM (8 GB recomendados). No separador «Applications» do formulário de encomenda, marque o GitLab.
- 2
Aguarde a entrega e ligue-se
A instalação e a primeira configuração demoram vários minutos após o arranque. Acompanhe-as por SSH e, quando terminar, leia a senha root.
Bashssh root@SERVER_IP tail -f /var/log/cloud-init-output.log sudo cat /etc/gitlab/initial_root_password - 3
Abra o GitLab e inicie sessão
Aceda a https://SERVER_IP e aceite o aviso do navegador, causado pelo certificado autoassinado. Inicie sessão com
roote a senha obtida acima, e altere-a de seguida no seu perfil.Bashsudo gitlab-ctl status - 4
Proteja o servidor para produção
Aponte um nome de domínio para o servidor e substitua
external_urlem/etc/gitlab/gitlab.rbporhttps://YOUR_DOMAIN. Ative o Let's Encrypt (letsencrypt['enable'] = true) ou instale o seu certificado e aplique a configuração. Restrinja o acesso com uma firewall (portas 22, 80 e 443) e agende cópias de segurança.Bashsudo nano /etc/gitlab/gitlab.rb sudo gitlab-ctl reconfigure sudo gitlab-backup create
Casos de uso de GitLab
Forja Git privada para equipas
Hospede o código-fonte dos seus projetos num servidor europeu que administra, com permissões por grupo e por projeto.
Pipelines de CI/CD internos
Execute testes e deploys a partir de ficheiros
.gitlab-ci.ymlversionados com o código, nos seus próprios runners.Migração de um serviço hospedado
Importe os seus repositórios do GitHub ou de outro GitLab para recuperar o controlo dos dados e das regras de acesso.
Ambiente de aprendizagem e testes
Experimente a configuração do GitLab, as cópias de segurança ou uma atualização de versão num servidor separado antes de mexer na produção.
Perguntas frequentes sobre GitLab
A receita indica 4 GB no mínimo e 8 GB recomendados, com pelo menos 2 núcleos de CPU. Abaixo disso, a instalação pode falhar ou a interface ficar muito lenta. Conte com 8 GB se usar CI/CD com regularidade.
Mais sobre GitLab
Substituir o certificado autoassinado
O certificado fornecido está associado ao endereço IP, por isso os navegadores mostram um aviso. Para o eliminar, use um nome de domínio (veja /web-domains) e edite /etc/gitlab/gitlab.rb:
Rubyexternal_url 'https://YOUR_DOMAIN' letsencrypt['enable'] = true letsencrypt['contact_emails'] = ['admin@YOUR_DOMAIN']
Depois execute sudo gitlab-ctl reconfigure. O domínio já deve apontar para o servidor, e as portas 80 e 443 têm de estar acessíveis para a validação.
Recursos e memória
O GitLab executa vários serviços (Puma, Sidekiq, PostgreSQL, Redis, Nginx, Gitaly). Com 4 GB de RAM, a instância funciona para uma equipa pequena, mas convém ter swap e alguma folga. Passe para 8 GB assim que tiver pipelines frequentes ou várias dezenas de utilizadores.
Cópias de segurança e atualizações
O comando sudo gitlab-backup create cria um arquivo com os dados da aplicação. Guarde também /etc/gitlab/gitlab.rb e /etc/gitlab/gitlab-secrets.json, que não fazem parte desse arquivo. Para atualizar, use sudo apt update && sudo apt install gitlab-ce. Consulte antes o caminho de atualização oficial, porque o GitLab por vezes exige versões intermédias.
