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

Automatizando a publicação do seu site: seu primeiro pipeline de CI/CD

Oi! Eu sou a Sensei da GeHost 🧑‍🏫 e hoje vamos falar de um assunto que parece assustador, mas que — prometo — fica bem tranquilo quando você entende a lógica por trás. Vamos aprender a configurar um pipeline de CI/CD, ou seja, um processo automático que pega o código que você (ou sua equipe) atualiza no Git e publica ele sozinho no servidor, sem você precisar subir arquivo manualmente toda vez.

CI/CD significa "Integração Contínua / Entrega Contínua" (Continuous Integration / Continuous Delivery). Na prática: você dá um "git push" e, minutos depois, seu site já está atualizado no ar. Mágica? Não — é automação bem configurada.

Antes de começar

Cada plano de hospedagem tem recursos diferentes disponíveis (acesso via SSH, Git integrado no cPanel, FTP, etc.). Por isso, o primeiro passo é sempre o mesmo:

• Acesse o painel.gehost.com.br e confira quais recursos de acesso e implantação estão liberados para o seu plano.
• Se tiver dúvida sobre o que está incluso, fale com o suporte antes de montar o pipeline — assim você já configura certo de primeira.
• Tenha seu projeto versionado em um repositório Git (GitHub, GitLab ou similar).

Passo a passo do pipeline

1. Faça um backup completo antes de tudo. Automação é ótima, mas o primeiro deploy automático merece uma rede de segurança. No cPanel, vá em Backup e gere uma cópia completa da sua conta antes de ligar qualquer automação.
2. Escolha o método de publicação disponível no seu plano. Existem dois caminhos comuns:
   • Git Version Control do cPanel — se o seu plano tiver essa ferramenta liberada, você pode conectar o repositório direto por lá e fazer o deploy com um clique ou webhook.
   • Deploy via FTP/SFTP — sua ferramenta de CI/CD (como GitHub Actions) envia os arquivos automaticamente para a pasta do site a cada atualização.
   Consulte o painel ou o suporte para confirmar qual opção está disponível para você.
3. Guarde suas credenciais como "segredos" (secrets), nunca no código. Se você usa GitHub Actions, por exemplo, cadastre usuário, senha/token e endereço de conexão em Settings > Secrets and variables > Actions do repositório. Assim, ninguém que olhar o código enxerga suas credenciais.
4. Crie o arquivo do workflow. Um exemplo simples de pipeline que publica por FTP a cada push na branch principal:

   name: Deploy
   on:
     push:
       branches: [ main ]
   jobs:
     deploy:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v4
         - name: Deploy via FTP
           uses: SamKirkland/FTP-Deploy-Action@v4
           with:
             server: ${{ secrets.FTP_SERVER }}
             username: ${{ secrets.FTP_USERNAME }}
             password: ${{ secrets.FTP_PASSWORD }}
             local-dir: ./dist/

   Ajuste a pasta local (local-dir) para onde seu projeto gera os arquivos prontos (build).
5. Teste primeiro em um ambiente ou pasta separada. Se possível, aponte o primeiro teste do pipeline para uma subpasta ou subdomínio de testes, e só depois de validar aponte para o site principal.
6. Confirme a publicação pelo Gerenciador de Arquivos. Depois que o pipeline rodar, entre no cPanel e confira se os arquivos chegaram certinho na pasta do site (geralmente public_html).
7. Acompanhe os primeiros deploys de perto. Nas primeiras execuções, fique de olho no log da ferramenta de CI/CD e no site publicado, só para confirmar que está tudo funcionando como esperado antes de "esquecer" o processo rodando sozinho.

Boas práticas de segurança

• Nunca deixe senhas ou tokens escritos direto no código do workflow — use sempre os "secrets" da ferramenta de CI/CD.
• Troque a senha de acesso usada pela automação periodicamente.
• Mantenha backups regulares mesmo depois que o pipeline estiver rodando redondinho — automação não substitui backup.
• Se o seu projeto lida com banco de dados, cuidado para o pipeline não sobrescrever configurações de conexão em produção sem querer.

Dica da Sensei: comece simples. Um pipeline que só publica arquivos estáticos já economiza um tempão. Depois, com calma, você vai incrementando com testes automáticos, notificações, etc.

Precisa de ajuda?

Se durante a configuração você tiver dúvida sobre quais recursos de acesso (SSH, Git, FTP) estão disponíveis no seu plano, ou travar em algum ponto, é só chamar o suporte da GeHost — a gente te ajuda a encontrar o melhor caminho para o seu caso.