Como configurar CI/CD simples para publicar atualizações automaticamente no VPS

Como configurar um CI/CD simples para publicar atualizações automaticamente

Oi, tudo bem? Aqui é a Sensei da GeHost 🎓 Vamos falar sobre um assunto que costuma parecer complicado, mas que, no fundo, é bem simples de entender: CI/CD (Integração Contínua / Entrega Contínua). Na prática, é só um jeito de fazer o seu site ou sistema se atualizar sozinho toda vez que você sobe uma alteração no seu repositório (GitHub, GitLab etc.), sem precisar copiar arquivo manualmente toda vez. Vem comigo que eu te explico passo a passo.

💡 Importante antes de começar: os planos de hospedagem da GeHost são baseados em cPanel. Isso significa que o caminho mais simples e seguro de automação é usar os recursos do próprio cPanel (como o Git Version Control). Se o seu projeto usa um ambiente diferente (por exemplo, um VPS com acesso próprio), os passos podem variar — nesse caso, fale com o nosso suporte pelo painel.gehost.com.br para a gente te orientar certinho de acordo com o seu ambiente.

O que você precisa antes de começar

• Um repositório do seu projeto (GitHub, GitLab ou similar) já funcionando.
• Acesso ao seu cPanel (usuário e senha, disponíveis no painel.gehost.com.br).
• Saber em qual pasta o seu site/sistema roda (geralmente public_html ou uma subpasta dela).

Passo 1 — Faça um backup antes de automatizar qualquer coisa

Regra de ouro aqui na GeHost: antes de mexer em automação, garanta um backup fresquinho. Assim, se algo sair diferente do esperado no primeiro teste, você volta atrás numa boa. No cPanel, vá até a área de Backup e gere um backup completo (ou parcial, se quiser só os arquivos e o banco de dados envolvidos).

Passo 2 — Conheça o caminho mais simples: Git Version Control do cPanel

O cPanel tem um recurso chamado Git™ Version Control, que permite clonar um repositório diretamente na sua hospedagem e, depois, atualizar (fazer "pull") das novas versões com poucos cliques ou até automaticamente via webhook.

1. No cPanel, procure pela ferramenta Git™ Version Control (geralmente na seção de arquivos/desenvolvimento).
2. Clique em Create (Criar) e informe a URL do seu repositório (ex.: o link do GitHub).
3. Defina o Repository Path — a pasta onde os arquivos vão ficar (aponte para dentro de public_html ou uma subpasta, conforme a estrutura do seu projeto).
4. Confirme a criação. O cPanel vai clonar o repositório nessa pasta.

Passo 3 — Deixe o "deploy" automático com um arquivo .cpanel.yml

Depois que o repositório está conectado, dá pra automatizar o que acontece a cada atualização (por exemplo, copiar os arquivos certos para a pasta pública) usando um arquivo chamado .cpanel.yml na raiz do repositório. Nele você descreve os comandos de deploy (como copiar arquivos de uma pasta para outra). Assim, ao clicar em "Deploy" (ou via webhook), o cPanel executa essas ações sozinho.

💡 Dica da Sensei: comece testando o deploy manualmente pelo botão "Deploy HEAD Commit" no próprio cPanel antes de automatizar de vez — assim você confirma que tudo funciona certinho antes de deixar no automático.

Passo 4 — Automatize de verdade com GitHub Actions (opcional, para quem já usa Git no dia a dia)

Se você já trabalha com GitHub Actions (ou GitLab CI), dá pra configurar um workflow que, a cada push na branch principal, conecta via SSH/SFTP na sua hospedagem e sincroniza os arquivos atualizados automaticamente, sem precisar clicar em nada no cPanel. Isso costuma envolver:

• Gerar uma credencial de acesso (usuário/senha ou chave) só para esse fim.
• Guardar essa credencial como "segredo" (secret) dentro das configurações do seu repositório — nunca deixe ela exposta no código.
• Um workflow (arquivo .yml) que roda o envio dos arquivos toda vez que houver uma atualização na branch principal.

Essa parte é um pouco mais técnica — se você não se sente confortável configurando sozinho, é só chamar o nosso suporte que a gente te ajuda a montar esse fluxo.

Passo 5 — Teste, acompanhe e ajuste

1. Faça uma alteração pequena no seu repositório (ex.: mudar um texto) e suba (push).
2. Confirme se a atualização apareceu no site/sistema dentro do tempo esperado.
3. Se algo não aparecer, volte ao Gerenciador de Arquivos e confira se os arquivos foram atualizados na pasta certa.

💡 Dica da Sensei: nunca automatize direto na sua branch de produção sem antes testar numa pasta/subdomínio separado. Um "ambiente de teste" evita dor de cabeça se alguma atualização vier com erro.

Precisa de ajuda?

Todo projeto entregue pela GeHost já vem com 30 dias de suporte grátis após a entrega — então, se você contratou desenvolvimento com a gente recentemente, é só chamar. Fora esse período, ou se quiser um suporte contínuo, dá pra falar com o time pelo painel.gehost.com.br que a gente te orienta sobre as opções disponíveis para o seu plano.

Automação de deploy parece um bicho de sete cabeças no começo, mas depois que está configurada, ela te devolve um tempo enorme no dia a dia. Bora automatizar? 🚀