すべてのリリースをスマホで確認
リリースが静かに失敗しても、ユーザーから壊れたサイトの報告を受けるずっと前に、数秒で気づけます。
どのパイプラインにも組み込める
GitHub Actions、GitLab CI、Jenkins、CircleCI はいずれも、パイプラインの末尾に 1 ステップ追加するだけで使えます。
成功と失敗を選んで通知
成功時、失敗時、またはその両方で送信できます。if: failure() で通知ステップを実行すれば、壊れたリリースの通知だけを受け取れます。
デプロイの詳細情報
メッセージにコミット、ブランチ、環境、実行 URL を含めれば、何がリリースされたかをすぐに把握できます。
環境ごとのチャンネル
環境ごとにアプリケーションを分ければ、本番、ステージング、プレビューのデプロイをそれぞれ別のチャンネルで受け取れます。
完了と同時に通知
ジョブが終わった時点でプッシュ通知が届くため、パイプラインのタブを閉じても結果がわかります。
設定はほぼ不要
ジョブに CLI を 1 回呼び出すか curl を 1 行書くだけで設定できます。Slack ボットをインストールする必要もありません。
デプロイ通知を設定する 3 つのステップ
API キーまたは Webhook URL を取得
CLI や curl の呼び出し用に API キーを作成するか、Webhook を作成して受信 URL をコピーします。
ステップまたは Webhook を追加
パイプラインに通知ステップを追加するか、Vercel または Netlify のデプロイ通知に受信 URL を貼り付けます。
安心してリリース
リリースすると、結果、コミット、環境を伝える通知がスマホに届きます。
すべてのデプロイで通知を受け取る
1. CI/CD パイプライン(CLI または curl)
GitHub Actions、GitLab CI、Jenkins、CircleCI のジョブ末尾に 1 ステップ追加してください。CLI を使う場合は次のとおりです。
pocketalert send -t "Deploy succeeded" -m "prod @ v2.4.0"
または、ランナーに何もインストールせずに済むよう、メッセージ API を curl で直接呼び出せます。
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 または Netlify(Webhook)
Webhook を作成すると、Vercel または Netlify が自身のデプロイ情報を Pocket Alert に POST できます。message フィールドは GJSON テンプレートで、相手のフィールドをプッシュ通知の内容に割り当てます。
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"}'
受信 URL は https://p4a.me/wh/1234abcd のような形式です。これを Vercel の Webhook 設定に貼り付けてください(deployment.succeeded などのイベントを指定します)。Netlify の場合は、デプロイ通知の送信 Webhook として追加し、%name% is %state% on %branch% のようにフィールドを割り当ててください。
メッセージ API と GJSON のフィールド割り当てについては、Webhook 設定のドキュメントをご覧ください。
よくある質問
GitHub Actions、GitLab CI、Jenkins、CircleCI のパイプライン末尾に通知ステップを追加します。Pocket Alert CLI か curl を実行すると、ジョブが終わった時点でデプロイ結果がプッシュ通知として届きます。
はい。ジョブのステータスを使って成功時と失敗時で異なるメッセージを送れます。通知ステップを if: failure() の条件でだけ実行すれば、届く通知は壊れたリリースのものだけになります。
メッセージ本文にコミット、ブランチ、環境、パイプラインの URL を含めてください。通知を見れば何がどこにリリースされたかがわかり、そのまま実行結果にも移動できます。
コマンドを実行できる仕組みならどれでも使えます。GitHub Actions、GitLab CI、Jenkins、CircleCI、Bitbucket Pipelines、通常のデプロイスクリプトなどです。Vercel と Netlify の場合は Pocket Alert で Webhook を作成し、その受信 URL をそれぞれのデプロイ通知設定に貼り付けてください。
本番、ステージング、プレビューごとにアプリケーションを分けて作成してください。本番デプロイは専用のチャンネルに届くため、リリースの種類をひと目で見分けられます。
はい。デプロイ失敗時は level=critical で送信してください。Android では、おやすみモードを突破する専用チャンネルに届きます。iPhone では、集中モードを突破する時間順守の通知として表示されます。日常的な成功通知は level=silent で送れば、振動せず履歴に残るだけになります。