Como configurar um webhook para disparar deploy automático a cada push no Git

Como configurar um webhook para disparar deploy automático a cada push no Git

Olá, querido(a) desenvolvedor(a)! Seja bem-vindo(a) ao seu novo Sensei da GeHost — aqui, a gente transforma tecnologia em algo simples, claro e humano. Hoje vamos aprender juntos como configurar um webhook para que seu site seja atualizado automaticamente a cada vez que você enviar código para o seu repositório no Git. Sim, é possível! E o melhor: sem precisar fazer deploy manualmente.

Imagine isso: você faz um push no GitHub, GitLab ou Bitbucket… e, em segundos, seu site já está com as novas alterações. Isso é deploy automático — e o webhook é o “gatilho” que faz isso acontecer. Vamos lá?

Passo a passo: como configurar o webhook no seu repositório

Antes de tudo, certifique-se de que:

• Seu projeto está no Git (GitHub, GitLab, Bitbucket).
• Seu site está hospedado na GeHost com acesso ao cPanel.
• Seu domínio está apontando para o servidor da GeHost (confira no painel do cliente).

Se tudo estiver certo, siga os passos abaixo:

1. Entre no seu painel da GeHost
   Acesse painel.gehost.com.br com suas credenciais. Este é o seu centro de controle.
2. Acesse o cPanel
   No painel, clique em cPanel (geralmente na seção “Hospedagem”).
   
3. Localize a pasta do seu site
   No cPanel, vá até a seção Arquivos e clique em Gerenciador de Arquivos.
   Selecione o domínio principal (ex: seusite.com.br) e clique em Ir para pasta.
   A pasta principal do seu site é public_html. É aqui que seu site vive.
4. Verifique se o Git está configurado
   Se você ainda não tem um repositório Git no servidor, você pode criar um com o comando no terminal (via SSH), mas isso é opcional. O importante é que o webhook será acionado via URL — então, o que precisamos é de um script que receba o webhook e faça o pull do código.
5. Crie um script de deploy automático
   No public_html, crie um arquivo chamado deploy.php com o seguinte conteúdo:

   <?php
// Executa o pull do repositório Git
$output = shell_exec('cd /home/SEU_USUARIO/public_html && git pull origin main');
echo "Deploy realizado com sucesso!
Resultado: " . $output;
?>

   Atenção: Substitua SEU_USUARIO pelo nome do usuário do cPanel (você encontra isso no painel). O branch pode ser main, master ou outro — ajuste conforme seu repositório.

6. Configure o webhook no seu repositório
   Acesse seu repositório no GitHub, GitLab ou Bitbucket.
   Vá até as configurações do repositório → Webhooks → Adicionar webhook.
   Preencha os campos:
   • Payload URL: https://seusite.com.br/deploy.php (substitua pelo seu domínio).
   • Content type: application/json.
   • Triggers: Selecione Push (para disparar a cada push).
   • Active: Marque como ativo.
7. Teste o webhook
   Faça um pequeno commit e push no repositório. Em seguida, abra o deploy.php no navegador (ex: https://seusite.com.br/deploy.php). Se tudo estiver certo, você verá a mensagem de sucesso e o código será atualizado automaticamente.

Dicas do Sensei

• Segurança é prioridade: Nunca deixe o deploy.php acessível publicamente sem proteção. Adicione autenticação (ex: chave secreta) ou restringir por IP, se possível.
• Use branches com cuidado: Se você usar main, certifique-se de que o repositório no servidor está no mesmo branch.
• Verifique logs: Se o deploy não funcionar, verifique o log do servidor ou use o painel da GeHost para ver erros.
• Backup sempre: Antes de ativar qualquer deploy automático, faça um backup completo da sua conta no cPanel (em Backup).

Pronto! Agora, cada vez que você fizer um push, seu site será atualizado automaticamente. É como ter um assistente digital cuidando do seu site enquanto você foca no que realmente importa: criar.

Se precisar de ajuda, o suporte da GeHost está disponível por 30 dias após a entrega — e sempre com um toque humano. Basta acessar o painel do cliente e abrir um ticket.

Com carinho,
Sensei da GeHost
*Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)*