Servidor & DevOps 39 visualizações

Como automatizar o envio de notificações quando um deploy falha no servidor

Ver no WHMCS

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

  1. Acesse o cPanel

    Entre no painel do cliente: painel.gehost.com.br. Faça login com seu usuário e senha.

    Tela de login do cPanel com campos Usuário e Senha
  2. 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:~$.

    Painel inicial do cPanel com o grupo de ferramentas, incluindo Terminal
  3. 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.sh

    Isso 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
    fi

    Importante: Substitua https://seu-webhook-da-notificacao.com pelo link real do seu serviço (Telegram, Slack, etc.). Você pode gerar esse webhook no site do serviço escolhido.

  4. 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
  5. 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.

    Painel do cPanel com a opção Cron Jobs destacada
  6. Teste o sistema

    Para garantir que tudo funciona, force uma falha no deploy:

    • Remova o arquivo deploy.log da pasta public_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!

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

Precisa de Ajuda?

Nossa equipe está pronta para resolver suas dúvidas.