Como configurar um pipeline de CI/CD com GitLab no VPS da GeHost imprimir

Como configurar um pipeline de CI/CD com GitLab na sua hospedagem GeHost

Oi! Eu sou a Sensei da GeHost, e hoje vamos falar de um assunto que deixa muita gente de olho brilhando: automatizar a publicação do seu site ou sistema usando GitLab CI/CD. Calma que não é bicho de sete cabeças — vou te guiar com carinho, passo a passo. 🧡

Antes de começar, um esclarecimento importante: os planos GeHost são hospedagem cPanel (Econômico, Básico, Médio e Plus), não servidores com acesso root. Isso não impede o CI/CD — só significa que a "ponte" entre o GitLab e sua hospedagem será feita via acesso SSH/Git (quando disponível no seu plano) ou via envio de arquivos, e não por comandos de administrador do sistema. Se tiver dúvida sobre o que seu plano libera, o caminho mais seguro é consultar o suporte ou o painel.gehost.com.br.

O que é CI/CD, em bom português

CI/CD é só uma forma bonita de dizer: "toda vez que eu salvar meu código no GitLab, ele testa e publica sozinho, sem eu precisar subir arquivo na mão". CI (integração contínua) cuida da parte de testar/preparar o código; CD (entrega contínua) cuida de mandar isso pra sua hospedagem.

O que você vai precisar

• Uma conta no GitLab com o repositório do seu projeto;
• Sua hospedagem GeHost ativa, com o domínio já apontando certinho;
• Saber se o seu plano tem acesso SSH liberado (confirme no painel do cliente ou com o suporte — nem todo plano tem esse recurso ativado por padrão);
• Um pouco de paciência no primeiro pipeline — depois disso, é tudo automático!

Passo a passo

1. Confirme o acesso e gere sua chave SSH

1. Entre no cPanel da sua hospedagem e verifique, junto ao suporte, se o seu plano possui acesso SSH disponível;
2. No seu computador, gere um par de chaves SSH (ex.: ssh-keygen -t ed25519);
3. Guarde a chave privada em local seguro — ela nunca deve ser exposta em nenhum código público;
4. A chave pública você vai cadastrar como autorizada de acordo com a orientação do suporte GeHost para o seu plano.

2. Cadastre a chave como variável segura no GitLab

1. No seu projeto GitLab, vá em Settings > CI/CD > Variables;
2. Crie uma variável (por exemplo SSH_PRIVATE_KEY) com o conteúdo da sua chave privada;
3. Marque como Protected e Masked — assim ela não aparece nos logs do pipeline, nem em branches não protegidas.

Dica de segurança da Sensei: nunca cole senhas, chaves ou dados de acesso direto no arquivo .gitlab-ci.yml. Sempre use as variáveis protegidas do GitLab. É a diferença entre dormir tranquilo e ter uma dor de cabeça.

3. Crie o arquivo .gitlab-ci.yml

Esse arquivo fica na raiz do seu repositório e é o "roteiro" do pipeline. Um exemplo simples, para publicar arquivos estáticos ou de um build (ajuste os caminhos e comandos para a realidade do seu projeto):

1. Um stage de build, que prepara os arquivos (ex.: npm install && npm run build, se for o seu caso);
2. Um stage de deploy, que envia os arquivos gerados para sua hospedagem via SSH (comandos como rsync ou scp costumam ser usados aqui);
3. Configure o deploy para rodar apenas na branch principal (ex.: main), evitando publicar testes por engano.

4. Teste o pipeline

1. Faça um commit e um push pequeno para disparar o pipeline;
2. Acompanhe o resultado na aba CI/CD > Pipelines do GitLab;
3. Se der erro, leia o log com calma — na maioria das vezes é caminho de pasta errado ou permissão da chave SSH.

5. Confira se publicou certinho

Depois que o pipeline rodar com sucesso, entre no cPanel e use o Gerenciador de Arquivos para conferir se os arquivos chegaram na pasta correta (geralmente public_html ou a subpasta do seu domínio).

Boas práticas para você levar pra vida

• Sempre teste em uma branch separada antes de fazer merge na principal;
• Tenha um backup recente antes de qualquer primeiro deploy automatizado — você encontra a opção de Backup no seu cPanel;
• Mantenha o SSL do seu domínio ativo, para que o site publicado continue seguro após cada deploy;
• Revise as variáveis do GitLab periodicamente e remova chaves que não usa mais.

Ficou com dúvida?

Se em algum momento você não souber se seu plano libera acesso SSH, ou precisar de ajuda para configurar as permissões corretas, é só chamar o suporte da GeHost ou dar uma olhada no painel.gehost.com.br. Estamos aqui torcendo pelo seu pipeline rodando verdinho! 💚