Servidor & DevOps 32 visualizações

Como configurar um pipeline de CI/CD para publicar automaticamente no VPS

Ver no WHMCS

O que é CI/CD e por que ele vai facilitar sua vida

Oi! Aqui é a Sensei da GeHost 🧘 Vamos falar de um assunto que parece complicado no nome, mas que no fundo resolve uma dor bem simples: parar de subir arquivo no servidor manualmente.

CI/CD é a sigla para "Integração Contínua" e "Entrega Contínua". Na prática, é um robozinho que fica de olho no seu repositório de código (Git) e, toda vez que você manda uma atualização, ele mesmo testa e publica essa atualização no seu servidor — sem você precisar copiar arquivo por FTP ou digitar comando nenhum.

Pense assim: hoje você atualiza o site "na mão". Com CI/CD, você só dá um git push e o resto acontece sozinho. Menos trabalho repetitivo, menos chance de esquecer um arquivo.

Antes de começar: o que você precisa ter em mãos

  • Seu código versionado num repositório Git (GitHub, GitLab ou Bitbucket, por exemplo).
  • Acesso ao servidor onde o projeto vai ser publicado (login e credenciais de acesso remoto).
  • Um pouquinho de paciência no primeiro dia — depois de configurado, é só usar!
Importante: os planos de hospedagem da GeHost são baseados em cPanel (o mesmo painel que você já usa para e-mail, arquivos e banco de dados). Se o seu projeto está numa VPS/servidor dedicado, o passo a passo abaixo se aplica direto. Se você está numa hospedagem compartilhada cPanel, veja a seção especial mais abaixo — o caminho é um pouco diferente.

Passo a passo para configurar o pipeline (ambiente com acesso via SSH)

Passo 1: Gere uma chave de acesso segura (SSH)

Em vez de usar senha (que pode ser interceptada ou fica salva em texto puro), o CI/CD usa uma chave SSH: um par de arquivos, um "público" (fica no servidor) e um "privado" (fica guardado com segurança na sua ferramenta de CI). É como uma fechadura e uma chave que só se encaixam uma na outra.

  1. Gere o par de chaves na sua máquina (a maioria dos tutoriais de Git/SSH ensina o comando certo para o seu sistema).
  2. Cadastre a chave pública no servidor de destino, na conta que vai receber o deploy.
  3. Guarde a chave privada como um "segredo" (secret) dentro da sua ferramenta de CI/CD — nunca cole ela direto no código.

Passo 2: Prepare um script de "recebimento" no servidor

É esse script que vai rodar sempre que uma nova versão chegar. Normalmente ele faz três coisas: baixa a atualização do repositório, instala dependências (se o projeto usar) e reinicia o que for necessário (por exemplo, um serviço da aplicação).

Dica de ouro: teste esse script manualmente antes de automatizar. Se ele funciona rodando "na mão", tem muito mais chance de funcionar sozinho depois.

Passo 3: Configure o pipeline na sua ferramenta de CI/CD

Se você usa GitHub, a ferramenta se chama GitHub Actions; no GitLab, é o GitLab CI/CD. Em ambos, você cria um arquivo de configuração dentro do próprio repositório que descreve:

  • Quando o pipeline deve rodar (ex.: sempre que houver push na branch principal).
  • Quais testes ou verificações rodar antes de publicar (opcional, mas recomendado).
  • Como conectar no servidor (usando a chave SSH guardada como segredo) e executar o script de deploy do Passo 2.

Passo 4: Teste com calma antes de confiar 100%

  1. Faça uma alteração pequena e sem risco no código (ex.: mudar um texto).
  2. Suba (push) essa alteração e acompanhe o pipeline rodando na sua ferramenta de CI.
  3. Confirme no site/aplicação se a mudança realmente apareceu.
  4. Só depois disso, use o pipeline para mudanças mais importantes.
Tenha sempre um backup recente antes de ligar o deploy automático de verdade. Automatizar é ótimo, mas o primeiro "susto" costuma acontecer justo quando ninguém está de olho.

E se o meu plano é hospedagem compartilhada (cPanel), não VPS?

Sem problema! Os planos GeHost funcionam em ambiente cPanel, então o caminho mais comum não é SSH direto para um servidor próprio, e sim um destes:

  • Git Version Control do cPanel: ferramenta que permite conectar um repositório Git e atualizar os arquivos da sua hospedagem por lá.
  • Deploy via SFTP/FTP a partir do CI: sua ferramenta de CI/CD envia os arquivos atualizados direto para a pasta do site (geralmente a public_html) usando as credenciais de acesso da sua conta.

Como o tipo de acesso disponível pode variar de plano para plano, o caminho mais seguro é confirmar com o suporte, ou verificar diretamente no painel.gehost.com.br, qual forma de acesso (SSH, SFTP ou Git Version Control) está disponível na sua conta antes de montar o pipeline.

Resumo da Sensei

CI/CD é, no fundo, ensinar um robô a fazer aquele passo repetitivo de "subir a atualização" por você — com mais segurança (chave em vez de senha solta) e menos chance de erro humano. Comece pequeno, teste bastante, e só depois confie o processo inteiro para o automático. E, na dúvida sobre o que sua hospedagem permite, o suporte da GeHost está aqui pra te ajudar a descobrir o melhor caminho. 🌱

Precisa de Ajuda?

Nossa equipe está pronta para resolver suas dúvidas.