Como configurar um pipeline de CI/CD simples para publicar atualizações no VPS automaticamente
Olá, querido(a) desenvolvedor(a) ou administrador(a) de site! Seja bem-vindo(a) ao seu novo caminho rumo à automação e produtividade. Aqui, na GeHost, acreditamos que tecnologia deve facilitar, não complicar. Por isso, vamos te guiar, passo a passo, como montar um pipeline de CI/CD simples — sim, mesmo que você nunca tenha ouvido falar desse termo antes!
Esse guia é feito com carinho para quem está começando, com linguagem clara, sem jargões desnecessários. Vamos usar apenas recursos que já estão disponíveis na sua hospedagem GeHost, sem precisar de mais nada. Prometemos: sem surpresas, sem complicações.
💡 Dica do Sensei: CI/CD é só um nome bonito para “testar o código e publicar automaticamente”. Você já faz isso manualmente? Agora vamos ensinar o computador a fazer isso por você!
Pré-requisitos: o que você precisa ter
Antes de começar, certifique-se de que você tem:
- Um domínio hospedado na GeHost (com acesso ao cPanel).
- Um repositório Git público (ex: GitHub, GitLab, Bitbucket).
- Acesso ao painel do cliente: painel.gehost.com.br.
- Conhecimento básico de Git (como fazer
git push).
Se você não tem um repositório, não se preocupe! Vamos usar o GitHub como exemplo, mas o processo é quase igual em qualquer plataforma.
Passo 1: Prepare seu repositório no GitHub
Se você ainda não tem um repositório, crie um no GitHub:
- Acesse github.com.
- Clique em “New repository”.
- Dê um nome (ex:
meu-site-automatizado). - Marque como público (para facilitar o acesso).
- Clique em “Create repository”.
Depois, adicione seu código (HTML, CSS, JS, PHP etc.) e faça o primeiro commit:
git init
git add .
git commit -m "Primeira versão do site"
git remote add origin https://github.com/seu-usuario/meu-site-automatizado.git
git push -u origin main
Passo 2: Configure o acesso SSH no cPanel
Para o GitHub enviar atualizações automaticamente para o seu servidor, ele precisa se conectar via SSH. Vamos permitir isso no cPanel:
- Entre no seu painel do cliente.
- Abra o cPanel (acesso via "Hospedagem" → "cPanel").
- Na seção “Segurança”, clique em “SSH Access”.
Na tela seguinte:
- Clique em “Manage SSH Keys”.
- Selecione “Generate” para criar uma chave SSH.
- Deixe o nome padrão (ex:
id_rsa) e clique em “Generate”. - Clique em “Copy Public Key” e cole a chave no GitHub.
Para adicionar a chave no GitHub:
- Entre em Settings → SSH and GPG keys.
- Clique em “New SSH key”.
- Coloque um título (ex: “GeHost - Meu Site”).
- Cole a chave pública (a que você copiou).
- Clique em “Add SSH key”.
Passo 3: Crie um script de deploy no servidor
Agora, vamos ensinar o servidor a saber o que fazer quando receber um novo código.
- No cPanel, vá até “Arquivos” → “Gerenciador de Arquivos”.
- Selecione a pasta
public_html(ou a pasta do seu site). - Clique em “Criar Arquivo” e nomeie como
deploy.sh.
Abra o arquivo deploy.sh e insira este conteúdo:
#!/bin/bash
# Script de deploy automático
cd /home/seu-usuario/public_html
git pull origin main
echo "Atualização concluída com sucesso!"
⚠️ Importante: Substitua seu-usuario pelo nome da sua conta no cPanel (você encontra isso no painel do cliente).
Salve o arquivo e, no cPanel, clique em “Permissões” no arquivo deploy.sh. Marque a opção “Executar” para o usuário (ou defina como 755).
Passo 4: Configure o webhook no GitHub
Quando você fizer um git push, o GitHub vai avisar o servidor. Isso é o webhook.
- No GitHub, vá até seu repositório → Settings → Webhooks.
- Clique em “Add webhook”.
- Na seção “Payload URL”, digite:
https://seu-domínio.com/deploy.sh(substitua por seu domínio real). - Selecione “application/json” como conteúdo.
- Escolha “Just the push event”.
- Clique em “Add webhook”.
💡 Dica do Sensei: Se o webhook falhar, verifique se o arquivo deploy.sh está no caminho certo e com permissão de execução.
Passo 5: Teste tudo!
Abra o terminal e faça um pequeno teste:
echo "Teste de atualização" >> index.html
git add .
git commit -m "Teste de CI/CD"
git push origin main
Depois de alguns segundos, o GitHub vai acionar o webhook. O servidor receberá a atualização e o script deploy.sh será executado automaticamente.
Volte ao site e atualize a página. Pronto! Sua nova atualização está online — sem você precisar fazer nada além de git push.
Conclusão: você está no controle
Parabéns, Sensei! Você acabou de montar um pipeline de CI/CD simples, seguro e funcional — tudo com recursos da sua hospedagem GeHost.
Este processo pode ser adaptado para qualquer tipo de site: blog, loja virtual, portfólio, sistema interno. E o melhor? Ele se atualiza sozinho. Você foca no que importa: criar, inovar, inspirar.
Se tiver dúvidas, lembre-se: a GeHost está aqui para te ajudar. Basta entrar em contato pelo painel do cliente ou enviar um e-mail para suporte@gehost.com.br.
Com carinho,
O Sensei da GeHost
*