Deploy e CI/CD

No instante em que um deploy termina.

Adicione um passo de notificação ao GitHub Actions, GitLab CI ou Jenkins, ou aponte um webhook de deploy da Vercel ou da Netlify para o Pocket Alert. O resultado do deploy chega ao seu celular em até um segundo após o fim do job, com o commit, a branch e o ambiente anexados.

Dispara com o status do jobUm passo no pipelineWebhook da Vercel · NetlifyAtualizado em
Recursos

Cada release no seu celular

Quando uma release falha em silêncio, você fica sabendo em segundos, muito antes de um usuário reclamar do site quebrado.

Funciona em qualquer pipeline

GitHub Actions, GitLab CI, Jenkins e CircleCI precisam, cada um, de um único passo no fim do pipeline.

Sucesso ou falha

Envie em caso de sucesso, de falha ou nos dois. Execute o passo de notificação com if: failure() para receber apenas avisos de releases quebradas.

Contexto do deploy

Coloque o commit, a branch, o ambiente e a URL da execução na mensagem para saber exatamente o que foi publicado.

Canais por ambiente

Um aplicativo separado por ambiente mantém os deploys de produção, staging e preview em canais próprios.

Instantâneo ao terminar

A notificação chega assim que o job termina, para você poder fechar a aba do pipeline.

Zero configuração

Uma chamada da CLI ou um curl no seu job. Não há bot do Slack para instalar.

Primeiros passos

Três passos para alertas de deploy

1

Obtenha a chave ou a URL do webhook

Crie uma chave de API para uma chamada com a CLI ou com curl, ou um webhook, e copie a URL de recebimento.

2

Adicione um passo ou webhook

Adicione um passo de notificação ao seu pipeline, ou cole a URL de recebimento nas notificações de deploy da Vercel ou da Netlify.

3

Publique com tranquilidade

Publique uma release e seu celular vibra com o resultado, o commit e o ambiente.

Receba notificação em todo deploy

1. Pipeline de CI/CD (CLI ou curl)

Adicione um passo no fim do seu job do GitHub Actions, GitLab CI, Jenkins ou CircleCI. Com a CLI:

pocketalert send -t "Deploy succeeded" -m "prod @ v2.4.0"

Ou use curl direto na API de mensagens, assim não há nada para instalar no runner:

curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Deploy succeeded","message":"prod @ v2.4.0","level":"silent"}'

2. Vercel ou Netlify (webhook)

Crie um webhook para que a Vercel ou a Netlify possam enviar o próprio payload de deploy ao Pocket Alert. O campo message é um template GJSON que mapeia os campos deles para a notificação push:

curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Vercel deploy","message":"%type%: %payload.project.name% on %payload.deployment.target%","application_id":"qm47b9pzxzxg"}'

Você recebe uma URL de recebimento como https://p4a.me/wh/1234abcd. Cole-a nas configurações de webhook da Vercel (eventos como deployment.succeeded). Para a Netlify, adicione-a como webhook de saída de notificação de deploy e mapeie os campos, por exemplo %name% is %state% on %branch%.

A documentação de configurações de webhook explica a API de mensagens e o mapeamento de campos GJSON.

FAQ

Dúvidas respondidas

Adicione um passo de notificação no fim do seu pipeline no GitHub Actions, GitLab CI, Jenkins ou CircleCI. Execute a CLI do Pocket Alert ou uma chamada com curl, e o resultado do deploy chega como notificação push assim que o job termina.

Sim. Use o status do job para enviar uma mensagem de sucesso ou de falha, e execute o passo de notificação apenas com if: failure() para que uma release quebrada seja o alerta que você recebe.

Coloque o commit, a branch, o ambiente e a URL do pipeline no corpo da mensagem. O alerta então mostra o que foi publicado e onde, e leva direto para a execução.

Qualquer coisa que execute um comando funciona: GitHub Actions, GitLab CI, Jenkins, CircleCI, Bitbucket Pipelines ou um script de deploy simples. Para Vercel e Netlify, crie um webhook do Pocket Alert e cole a URL de recebimento nas configurações de notificação de deploy.

Crie um aplicativo separado para cada ambiente: produção, staging e preview. Os deploys de produção chegam então no próprio canal, e você diferencia as releases de relance.

Sim. Envie os deploys com falha com level=critical: no Android eles são publicados em um canal dedicado que ignora o Não perturbe, e no iPhone aparecem como notificações urgentes que furam o Foco. Avisos rotineiros de sucesso podem ser enviados com level=silent, ficando no histórico sem vibrar.

Saiba como cada release foi concluído.

Adicione um passo ao seu pipeline e o resultado de cada release chega no seu celular assim que ele é publicado.