Como configurar deploy automático via Git usando webhooks no cPanel imprimir

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”).

Importante: 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.sh tem 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. 🤝

Importante: 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 🌿