Como automatizar o envio de notificações quando um deploy falha no servidor
Olá, querido(a) desenvolvedor(a) ou administrador(a) de site! Seja bem-vindo(a) ao seu novo passo rumo à tranquilidade digital. Aqui, na GeHost, entendemos que um deploy falhando pode ser um momento de estresse — mas não precisa ser. Com algumas configurações simples no seu servidor, você pode se manter informado na hora, sem precisar vigiar o servidor 24h por dia.
Este guia vai te ensinar, passo a passo, como configurar um sistema que envia uma notificação automaticamente sempre que um deploy (envio de código) falha no seu servidor. Vamos com calma, como se fosse um chá de menta com o Sensei — calmo, claro e com propósito.
Antes de começar: o que você precisa
- Um domínio hospedado na GeHost (com acesso ao cPanel).
- Permissão para executar scripts no servidor (via SSH ou terminal no cPanel).
- Um e-mail profissional (já incluso no seu plano GeHost).
- Um serviço de notificação externo (como Telegram, Slack ou WhatsApp via API).
Dica do Sensei: Se você não tem certeza se seu plano permite SSH, acesse o painel do cliente e verifique a aba "Acesso SSH". Se não aparecer, fale com o suporte — talvez precise ativar.
Passo a passo: configure a notificação automática
-
Acesse o cPanel
Entre no painel do cliente: painel.gehost.com.br. Faça login com seu usuário e senha.
-
Abra o terminal (SSH) no cPanel
No painel inicial, procure por “Terminal” ou “SSH Access”. Clique para abrir. Você verá uma tela com um prompt como
user@host:~$.
-
Crie um script de monitoramento
Esse script vai verificar se o deploy foi bem-sucedido. Vamos chamá-lo de
deploy-check.sh.No terminal, digite:
nano deploy-check.shIsso abrirá um editor de texto. Cole o código abaixo (ajuste conforme sua necessidade):
#!/bin/bash # Verifica se o deploy foi concluído com sucesso if [ ! -f "/home/usuario/public_html/deploy.log" ]; then echo "Deploy falhou: arquivo de log não encontrado." # Aqui envia a notificação curl -X POST -H "Content-Type: application/json" \ -d '{"text":"🚨 Falha no deploy! Verifique o servidor."}' \ https://seu-webhook-da-notificacao.com fiImportante: Substitua
https://seu-webhook-da-notificacao.compelo link real do seu serviço (Telegram, Slack, etc.). Você pode gerar esse webhook no site do serviço escolhido. -
Salve e torne o script executável
No editor
nano, pressione Ctrl + O para salvar, depois Enter. Para sair, pressione Ctrl + X.Em seguida, dê permissão para executar:
chmod +x deploy-check.sh -
Configure o cron para rodar o script
O cron é o “relógio” do servidor. Ele executa tarefas automaticamente.
No cPanel, vá até “Cron Jobs” (em Ferramentas de Sistema).
Configure assim:
- Comando:
/home/usuario/deploy-check.sh - Intervalo:
*/5 * * * *(executa a cada 5 minutos)
Salve a tarefa.
- Comando:
-
Teste o sistema
Para garantir que tudo funciona, force uma falha no deploy:
- Remova o arquivo
deploy.logda pastapublic_html. - Espera 5 minutos.
- Verifique se você recebeu a notificação no seu serviço (Telegram, Slack, etc.).
Se sim, parabéns! Seu sistema de alerta está funcionando!
- Remova o arquivo
Dica extra do Sensei
Se quiser ir além, você pode adaptar o script para enviar mais detalhes: data do erro, nome do deploy, mensagem de log — tudo isso pode ser incluído no corpo da notificação. Basta ajustar o curl com mais dados JSON.
Atenção: Nunca deixe dados sensíveis (como senhas ou chaves) no script. Use variáveis de ambiente ou arquivos protegidos.
Pronto! Você está no controle
Agora, cada vez que um deploy falhar, você será avisado imediatamente. Isso significa menos tempo perdido, menos estresse e mais foco no que realmente importa: criar coisas incríveis.
Se precisar de ajuda, o suporte da GeHost está aqui — com 30 dias grátis após a entrega. Basta entrar em contato pelo painel ou pelo e-mail suporte@gehost.com.br.
Até a próxima, com o coração leve e o código limpo. 🌿
GeHost — hospedagem com alma, desde 2015. Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04).