HELPER VPS

Hospedagem VPS GitLab: código e CI/CD no seu servidor

  • Instalação com a imagem Docker oficial gitlab/gitlab-ce
  • Planos com 16 GB de memória ou mais recomendados
  • Acesso root e endereços IPv4 e IPv6 públicos

O HELPER VPS GitLab VPS é um servidor Linux na nuvem onde você executa o GitLab Community Edition, que gerencia repositórios Git e CI/CD em um só lugar, faturado por nota fiscal a partir de $25.00 por mês. Escolha a imagem do app Docker ao criar o servidor, conecte-se via SSH e execute a imagem oficial gitlab/gitlab-ce, e você poderá gerenciar o código, issues e pipelines da sua equipe no seu próprio servidor.

    O que é GitLab?

    O GitLab é uma plataforma de desenvolvimento que reúne gestão de repositórios Git, revisão de código, gestão de issues, pipelines de CI/CD e registro de contêineres. O GitLab Community Edition (CE) é a edição grátis de código aberto, que as equipes instalam no próprio servidor para guardar código e histórico de desenvolvimento. Funções de colaboração como merge requests, wiki e marcos já vêm incluídas.

    A imagem Docker oficial gitlab/gitlab-ce traz, junto com o GitLab, PostgreSQL, Redis, Nginx, Puma e Sidekiq, então todo o serviço roda em um contêiner. Configurações, logs e dados ficam à parte no disco do servidor em volumes, então mesmo trocando o contêiner pela nova versão, repositórios e dados de usuários continuam.

    O que posso fazer com um VPS GitLab?

    Com um servidor GitLab auto-hospedado, reúna no seu servidor todo o fluxo de desenvolvimento.

    Como compro um servidor GitLab?

    Do seu primeiro pagamento ao seu primeiro login, são três passos.

    1. Passo 1. Escolha um plano com 16 GB ou mais

      Escolha um método de pagamento, selecione uma cidade próxima da sua equipe e escolha um plano com 16 GB de memória ou mais.

    2. Passo 2. Criar com a imagem do app Docker

      Escolhendo Docker na lista de imagens, é criado um servidor Ubuntu 24.04 com Docker Engine e Docker Compose prontos.

    3. Passo 3. Acessar por SSH e rodar o comando

      Entre como root por SSH, rode o comando abaixo e, alguns minutos depois, abra o endereço do servidor no navegador e entre com a conta root.

    Como instalo o GitLab CE?

    Entre por SSH no servidor criado com a imagem do app Docker e rode o comando abaixo. Troque gitlab.example.com pelo seu domínio ou IP do servidor; como o SSH do servidor usa a porta 22, o Git SSH do GitLab abre na porta 2222. A primeira inicialização leva alguns minutos, e com o comando da última linha você vê a primeira senha de root (o arquivo é apagado em 24 horas).

    Terminal
    export GITLAB_HOME=/srv/gitlab
sudo mkdir -p $GITLAB_HOME
sudo docker run --detach \
  --hostname gitlab.example.com \
  --publish 443:443 --publish 80:80 --publish 2222:22 \
  --name gitlab \
  --restart always \
  --volume $GITLAB_HOME/config:/etc/gitlab \
  --volume $GITLAB_HOME/logs:/var/log/gitlab \
  --volume $GITLAB_HOME/data:/var/opt/gitlab \
  --shm-size 256m \
  gitlab/gitlab-ce:latest
sudo docker logs -f gitlab
sudo docker exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password

    Que vantagens tem instalar o GitLab em um VPS?

    Operando você mesmo um VPS GitLab, você trata código e pipelines com os seus critérios.

    Tecnologias usadas com o GitLab

    A imagem oficial do GitLab CE traz dentro as tecnologias abaixo e as roda juntas sobre o VPS GitLab.

    Coloque seu servidor perto dos seus clientes

    Crie servidores GitLab pelo mesmo preço em qualquer uma das 40 cidades de 31 países.

    Quantos GB de memória o VPS GitLab precisa?

    O GitLab roda um servidor web, tarefas em segundo plano, um banco de dados e um cache juntos, então precisa de pelo menos 4 GB de memória, e recomendamos 16 GB ou mais para uso real de equipe. Com 12 GB, a interface pode ficar lenta com apenas algumas pessoas ao mesmo tempo, então na HELPER VPS recomendamos começar com um plano de 4 vCPU e 16 GB. Um plano de alto desempenho com um disco NVMe torna clones de repositórios e buscas mais rápidos.

    Se vai rodar também tarefas de CI com o GitLab Runner no mesmo servidor, os builds usam memória junto, então o plano de 16 GB é o ideal. Equipes com muitos usuários e projetos escolhem planos com muita memória, como o m32 de memória, e separando o Runner em outro servidor, a tela do GitLab fica sempre leve. Cada conta cria até 10 servidores, então separar assim também é fácil.

    O que configurar depois de começar a auto-hospedagem do GitLab?

    Depois do primeiro login, troque a senha de root e, na área de administração, deixe o cadastro com aprovação ou fechado para só a equipe entrar. Se usa domínio, defina external_url em /srv/gitlab/config/gitlab.rb com o endereço https, ative a configuração letsencrypt e rode sudo docker exec -it gitlab gitlab-ctl reconfigure, e o certificado HTTPS é aplicado automaticamente.

    Os e-mails de aviso são enviados colocando nas configurações SMTP do gitlab.rb um serviço de envio que use a porta 587. Para o endereço Git SSH aparecer com a porta 2222, defina o valor gitlab_rails['gitlab_shell_ssh_port'] como 2222. Crie backups com regularidade com sudo docker exec -t gitlab gitlab-backup create e, ao subir para versões novas, confira o caminho oficial de atualização antes de trocar a imagem, para ficar seguro.

    Perguntas frequentes sobre hospedagem GitLab

    Perguntas frequentes ao escolher e instalar um VPS GitLab.

    O VPS GitLab é instalado em um clique?

    Depois de criar o servidor com a imagem do app Docker, rode a imagem oficial gitlab/gitlab-ce com um único comando docker run. Colando o comando acima e esperando alguns minutos, a tela de login do GitLab abre no navegador.

    De quantos GB de memória o GitLab precisa no mínimo?

    O GitLab precisa de pelo menos 4 GB de memória, e recomendamos 16 GB ou mais para uso confortável de equipe. Então recomendamos começar com um plano de 4 vCPU e 16 GB (g16, n16), e um plano de 32 GB se você também rodar um CI Runner.

    Posso instalar com o pacote Omnibus na imagem Ubuntu?

    Sim, também dá para adicionar o repositório oficial de pacotes do GitLab em um servidor criado com Ubuntu e instalar. O modo Docker separa configurações, logs e dados em volumes, facilitando atualizações e migrações, por isso esta página orienta pelo modo Docker.

    Onde vejo a primeira senha de root?

    Confira com o comando sudo docker exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password. Esse arquivo é apagado 24 horas depois da configuração inicial, então troque por uma nova senha assim que entrar.

    Que porta o Git SSH usa?

    Como o SSH do próprio servidor usa a porta 22, o comando acima abre o Git SSH do GitLab na porta 2222. Definindo gitlab_shell_ssh_port como 2222 no gitlab.rb, o endereço SSH da tela de repositórios também aparece correto.

    Como coloco o certificado HTTPS?

    Depois de fazer o domínio apontar para o IP do servidor, mude external_url no gitlab.rb para o endereço https, ative letsencrypt e rode gitlab-ctl reconfigure: o certificado é emitido e renovado automaticamente.

    O GitLab Runner também pode ficar no mesmo servidor?

    Sim, basta subir a imagem gitlab/gitlab-runner como contêiner no mesmo servidor e registrá-lo. Os builds usam memória e CPU juntos, então recomendamos escolher o plano de 16 GB ou deixar o Runner à parte em um servidor pequeno.

    O GitLab pode enviar alertas por e-mail?

    Sim, colocando nas configurações SMTP do gitlab.rb um serviço de envio que use a porta 587, saem os avisos de merge requests e issues. Os servidores da HELPER VPS têm a porta 25 de saída fechada, então o envio é feito assim.

    Como atualizo o GitLab?

    Crie um backup com gitlab-backup, baixe a nova imagem e recrie o contêiner com os mesmos volumes. Ao pular versões grandes, suba passando pelas versões intermediárias conforme o caminho oficial de atualização do GitLab.

    Posso ampliar o disco quando os repositórios crescerem?

    Ao criar o servidor, você pode somar um disco adicional entre 50 e 1000 GB. Definindo GITLAB_HOME no caminho do disco adicional, repositórios, registro e backups ficam em um espaço amplo.

    Como pago a compra do servidor GitLab?

    Escolha um método de pagamento e crie um servidor para começar a usá-lo imediatamente. Pague a nota fiscal de renovação antes do período terminar e seu desenvolvimento nunca para.

    O GitLab é um projeto de código aberto feito pela GitLab Inc. e pela comunidade, e os direitos sobre o nome e o logotipo do GitLab pertencem ao seu dono. Instalação, atualizações, configuração e suporte ao uso do GitLab CE ficam com o cliente. O GitLab CE é usado sem custo extra, e a cobrança do servidor é o preço do plano escolhido.

    Guias do servidor GitLab

    O que vale a pena fazer logo depois de receber o servidor.