Como configurar deploy automático via Git usando webhooks no cPanel
Olá, querido(a) desenvolvedor(a) e empreendedor(a)! 👋 Seja bem-vindo(a) ao nosso guia de deploy automático com Git e webhooks no cPanel, feito especialmente para quem quer entregar código com mais rapidez, menos cliques e mais tranquilidade. Aqui, você vai aprender a configurar um fluxo mágico: toda vez que você enviar um novo código ao seu repositório no GitHub, GitLab ou outro serviço, o seu site será atualizado automaticamente — sem precisar fazer upload manual!
Seja você um freelancer, um time pequeno ou um empreendedor que quer focar no produto e não na logística, esse guia vai te ajudar a ganhar tempo e evitar erros humanos. Vamos lá, com calma, passo a passo — como se fosse uma conversa entre amigos no café. ☕
Antes de começar: o que você precisa ter
- Um domínio já hospedado na GeHost (com cPanel ativo).
- Um repositório Git (GitHub, GitLab, Bitbucket, etc.) com seu código.
- Permissão de acesso ao cPanel da sua conta.
- Seu código já no repositório, e pronto para ser deployado.
Dica Sensei: Se você ainda não tem um repositório, crie um agora no GitHub ou GitLab, e faça o primeiro commit. Depois, volte aqui para continuar!
Passo 1: Acesse o cPanel da sua conta
Entre no painel do cliente da GeHost: painel.gehost.com.br.
Logue com seu usuário e senha. Após o login, você verá a tela principal do cPanel.
Passo 2: Acesse o Gerenciador de Arquivos (File Manager)
No cPanel, localize o grupo “Arquivos” e clique em “Gerenciador de Arquivos”.
Selecione a pasta public_html (ou a subpasta onde seu site está hospedado) e clique em “Ir”.
Passo 3: Inicialize um repositório Git no servidor
No Gerenciador de Arquivos, clique com o botão direito na pasta public_html (ou sua pasta raiz) e selecione “Criar repositório Git”.
Na janela que abrir, confirme o nome do repositório (geralmente o nome do domínio) e clique em “Criar”. Isso vai ativar o Git no servidor da GeHost.
Dica Sensei: Esse passo é essencial! Sem ele, o webhook não saberá onde aplicar as atualizações.
Passo 4: Configure o webhook no seu repositório remoto
Agora, vamos para o seu repositório no GitHub, GitLab ou outro serviço.
Procure por “Settings” → “Webhooks” (ou “Integrações”, dependendo da plataforma).
Clique em “Add webhook”.
Na configuração, preencha:
- Payload URL:
https://seu-dominio.com.br/cpanel-webhook(substitua “seu-dominio.com.br” pelo seu domínio real). - Content type:
application/json - Which events would you like to trigger this webhook? Escolha “Just the push event” (ou “Pushes”).
Quan trọng: O caminho /cpanel-webhook é um endpoint padrão que o cPanel entende. Ele vai receber o webhook e acionar o pull automático do código.
Passo 5: Crie o script de deploy no cPanel
Volte ao cPanel e no Gerenciador de Arquivos, abra a pasta public_html.
Crie um novo arquivo chamado deploy.sh (ou use um editor de texto do cPanel).
Coloque dentro dele o seguinte conteúdo:
#!/bin/bash
cd /home/SEU_USUARIO/public_html
git pull origin main
Atenção: Substitua SEU_USUARIO pelo nome real do usuário da sua conta no cPanel (você pode ver isso no painel).
Salve o arquivo.
Dica Sensei: Se o seu branch principal for master ou outro nome, troque main por master ou o nome correto.
Passo 6: Torne o script executável
Volte ao Gerenciador de Arquivos, clique com o botão direito no arquivo deploy.sh e selecione “Editar”.
Na parte superior da tela, clique em “Permissões” ou “Change Permissions”.
Marque as opções para leitura, escrita e execução para o dono (usuário) e o grupo.
Salve as alterações.
Passo 7: Teste o deploy
Volte ao seu repositório remoto (GitHub/GitLab), faça um pequeno ajuste no código (ex.: altere uma frase no index.html).
Comite e envie (push) as alterações.
Volte ao cPanel e verifique se o arquivo deploy.sh foi executado. Você pode verificar isso no histórico de logs ou esperar alguns segundos.
Atualize o seu site no navegador — e veja o novo código aparecendo!
Parabéns! Você acaba de automatizar o deploy do seu site com Git e webhooks. 🎉
Como manter tudo funcionando
- Se o deploy falhar, verifique se o script
deploy.shtem permissão de execução. - Confirme se o nome do branch no script está correto (main, master, etc.).
- Se algo não funcionar, entre em contato com o suporte da GeHost — eles vão te ajudar com carinho. 🤝
Quan trọng: O suporte da GeHost está disponível por 30 dias após a entrega. Se precisar de ajuda com o setup, é só entrar em contato pelo painel ou pelo e-mail de suporte. Não se preocupe — estamos aqui para te ajudar!
Conclusão
Configurar deploy automático via Git e webhooks no cPanel pode parecer mágica… mas na verdade é só tecnologia bem usada. Com esse guia, você já está no caminho certo para entregar código mais rápido, com menos erros e mais foco no que realmente importa: o seu negócio.
Se gostou, compartilhe com um colega. E se tiver dúvidas, lembre-se: GeHost está com você.
Com carinho, seu Sensei da GeHost 🌿