Bitbucket Pipelines の通知
Bitbucket Pipelines はチームのチャット ルームやユーザーのメール アドレスに通知を送信できます。
参考資料
チャット通知
Slack
Pipelines では、既存の Bitbucket 通知以外にも、リポジトリ全体または特定のブランチに対して、パイプラインやデプロイメントの結果について Slack に通知できます。
Slack アプリのインストール
- 通知を設定するリポジトリを開きます。
- Click Repository settings then select Slack > Settings.
- Slack の下の [接続] ボタンをクリックします。Slack にログインしていない場合は、Slack のログイン ダイアログが開かれる場合があります。
- リポジトリに接続する Slack ワークスペースを選択します。
Slack に「ようこそ」メッセージが自動的に送信されます。
次に、リポジトリ固有の設定で、受信する通知を選択します。通知は、リポジトリ全体またはブランチ単位で構成できます。
- Slack に接続しているいずれかのリポジトリを開きます。
- [リポジトリ設定] をクリックしてから、[チャット通知] > [設定] を選択します。
- 関連ブランチの右側にある下矢印
を選択するか、必要に応じて新しく作成します。 - 受信する通知を選択します。
注: ブランチごとに通知を設定すると便利です。例えば、master ブランチでは pipeline fixed 通知を受信するが、リポジトリ内のその他のブランチでは受信しないようにすることが重要な場合があります。
Pipelines では次のような通知を利用できます。
- pipeline succeed
- pipeline failed
- pipeline fixed (失敗した試行の後に正常に完了した場合)
- デプロイメントの成功
- deployment failed (エラー ステータスを含む)
- deployment stopped (同時実行による一時停止を含む)
既定の構成はここに表示されます。
注: build failed および build succeeded は外部サードパーティ ツール用であり、Bitbucket Pipeline 通知には含まれません。
Slack でパイプラインの失敗通知を受け取ったら、Slack のチャンネルから失敗したビルドを再実行できます。
メール通知
以下に関するメールを受信できます。
- プッシュおよびパイプラインが失敗したとき。
- リポジトリ内でのすべての失敗したパイプライン。
アカウントの Bitbucket 設定にメール アドレスを設定している場合、自身のプッシュがトリガーしたパイプラインが失敗すると、通知が送信されます。
現在、「メールを有効化 / 無効化する」のステップに従って通知の登録を解除できます。
手動ステップと通知
Pipeline の完了通知は、パイプライン内で実行できるステップがそれ以上ない場合に送信されます。つまり、次のような場合に通知が送信されます。
- パイプラインの最初の自動ステップが完了したとき (以降の手動ステップが引き続き実行されている場合を含む)。
- 手動ステップ (および以降の自動ステップ) が完了したとき (以降の手動ステップが引き続き実行されている場合を含む)。
この機能は、手動のデプロイメント ステップを使用している際の主要なユースケースである、チームへのデプロイメント通知を実現できるように設計されています。
一部の通知チャンネルでは、ビルドのステータスをフィルターし、手動ステップから通知をさらに絞り込むことができます。
一般的な Webhook
Webhook を作成して、他のサービス向けに通知をセットアップできます。
Pipelines 固有の次の Webhook を追加できます。
- Build status updated: 成功または失敗の通知を取得します
- Build status created: パイプラインが開始されたら通知を受け取ります