プランとそのジョブの通知の設定
Bamboo の通知は、ビルド完了、ビルド結果、ビルド結果に対して投稿されたコメントなど、 プランとそのジョブに関するさまざまなイベントによってトリガーされます。特定のイベントの通知をプランやジョブごとに送信するかどうかや、送信先を設定できます。
Bamboo users can choose whether to receive their notifications via email, IM, both or neither. In general, recipients do not require Bamboo user accounts.
プランやジョブの通知を追加する
始める前に
On this page:
- プランに対する「編集」権限がある場合は、プランの通知を追加または削除できます。
- You need to configure Bamboo's SMTP email and/or instant messaging capabilities before Bamboo can send notifications. If you have not configured either or both of these, a note will display on the page prompting you to set up the appropriate server(s):
- To configure an email server for Bamboo, click Add an Email Server in the note and enter the email server details in the window that displays. See Configuring Bamboo to send SMTP Email for more information.
- To configure an instant messaging server for Bamboo, click Add an Instant Messaging Server in the note and enter the instant messaging server details in the window that displays. See Configuring Bamboo to use Instant Messaging for more information.
プランやそのジョブの通知を追加するには、次の手順に従います。
- 「プランの設定」に記載された手順で、目的のプランの設定に移動します。
- [通知] タブをクリックします。
[Add Build Notification (ビルド通知を追加)] セクションに新しい通知を次のように設定します。
設定 注意 イベント 通知を受け取るイベント タイプを選択します。詳細については、イベントのリスト (下記) をご参照ください。 受信タイプ ユーザー — 該当する Bamboo ユーザーのユーザー名を入力するか、アイコンをクリックしてユーザーのリストから選択します。 HipChat — HipChat の API トークンとルーム名を入力します。詳細については、「Bamboo と HipChat の統合」をご参照ください。
Group — Enter the name of the appropriate Bamboo group(s).
メール アドレス — メールを使用して、Bamboo ユーザーではないユーザーに通知を送信できます。適切なメール アドレスを入力してください。次の点にご注意ください。
- 既存の Bamboo ユーザーのメール アドレスを指定すると、ユーザー設定で通知を受け取らないように選択していても、ユーザーは通知を受け取ります。
IM アドレス — これは、Bamboo ユーザーではない人にインスタントメッセンジャー (IM) 通知を送信する必要がある場合に便利です。適切な IM アドレスを入力してください。次の点にご注意ください。 If you specify a broadcast address (eg. 'project-x@broadcast.chat.mycompany.com'), Bamboo will not know the context of relatedIM responses.
- 既存の Bamboo ユーザーの IM アドレスを指定すると、ユーザー設定で通知を受け取らないように選択していても、ユーザーは通知を受け取ります。
責任ユーザー — ビルドが失敗した場合の責任者として割り当てられた Bamboo ユーザー。「ビルドの失敗に対する責任の割り当て」をご参照ください。 コミッター — ビルドが最後に Bamboo によってチェックアウトされてから、特定のビルドにコードをコミットした Bamboo ユーザー。
Committers are notified based on the notification preference of a user. If there's no user linked to a repository, Bamboo doesn't send notifications.
ウォッチャー — このプランをお気に入りの 1 つとしてマークしている Bamboo ユーザー。 - [追加] をクリックしてから、必要に応じてさらに通知を設定します。
- 完了したら、[保存] をクリックします。
スクリーンショット: プラン ビルド通知
通知イベント
プラン イベント | 説明 |
---|---|
すべてのビルドが完了 | Bamboo は、プランのビルド結果に関係なく、プランのビルドが完了するたびに通知を送信します。この通知は、最新のビルド アクティビティに関する情報をユーザーに知らせる必要があるすべてのプランにおすすめです。 |
ビルド ステータスの変更 | Bamboo は、連続したプランのビルドでプランのビルド アクティビティのステータスが変化した場合にのみ通知を送信します。たとえば、プランの最新ビルドが成功から失敗に、またはその逆に変わった (つまり、「修正」された) ときのみなどです。 |
ビルドが失敗した後に初めて成功 | Bamboo は次の場合に必ず通知を送信します。 - このプランのビルドに失敗した。 - プランが「修正」された (つまり、プランの最新のビルドが成功し、かつ前のプランのビルドは失敗した状態)。 この通知は、一般にほとんどのプランに適しています。 |
X 回のビルド失敗後 | この通知では、Bamboo が通知を送信するまでの失敗回数 (つまり、このプランで失敗したビルドの数) を指定できます。 |
コメント追加時 | Bamboo は、ビルド結果にコメントが追加されるたびに通知を送信します。メール通知にはプランのビルドに対するすべてのコメントが含まれますが、IM 通知にはこの通知イベントをトリガーしたコメントのみが含まれます。 |
責任の変更 | Bamboo は、ビルドが失敗した場合の責任者のリストにユーザーが追加/削除されるたびに通知を送信します。 |
ジョブ イベント |
|
すべてのジョブが完了 | Bamboo は、ジョブ ビルドの結果に関係なく、プランのジョブ ビルドが完了するたびに通知を送信します。この通知は、このプランにあるすべてのジョブの最新のビルド アクティビティに関する情報をユーザーに知らせる必要がある場合におすすめです。 |
ジョブ ステータスの変更 | Bamboo は、連続したプランのビルドでこのプラン内のジョブのアクティビティ ステータスが変化した場合にのみ通知を送信します。たとえば、このプランのいずれかのジョブの最新ビルドが成功から失敗に、またはその逆に変わった (つまり、「修正」された) ときのみなどです。 |
失敗したジョブと最初の成功 | Bamboo は次の場合に必ず通知を送信します。 - このジョブのビルドに失敗した。 - ジョブが「修正」された (つまり、ジョブの最新のビルドは成功し、前のジョブのビルドは失敗)。 |
プランで最初に失敗したジョブ | プラン内で複数のジョブが失敗した場合、Bamboo は、Bamboo システムによって検出された最初の失敗ジョブについてのみ通知を送信します。 |
ジョブ エラー | Bamboo は、プランのジョブ ビルド プロセス (つまり、Bamboo がジョブ ビルドを実行するために行うアクティビティ) のいずれかでエラーが発生するたびに通知を送信します。このイベントは、実際のビルド自体の失敗とは関係ありません (上記のイベント「失敗したジョブと最初の成功」と「失敗したビルドと最初の成功」を参照してください)。例えば、リポジトリの接続時や変更の検出時に Bamboo でエラーが発生した場合、通知が送信されます。 |
ジョブのハング | Bamboo は、ハングしたジョブ ビルドの基準に従って、プランのジョブ ビルドのいずれかがハングしたと判断すると、通知を送信します (ハングしたジョブ ビルド設定の構成について詳細をご確認ください)。 |
ジョブ キューのタイムアウト | Bamboo は、プランのいずれかのジョブ ビルドがビルド キューのタイムアウト基準よりも長い間キューで待機していると、必ず通知を送信します (ジョブのビルド キューのタイムアウト設定の構成について詳細をご確認ください)。 |
ビルドできるエージェントがない状態でジョブをキューに登録 | Bamboo は、プランのいずれかのジョブ ビルドがキューに登録されていて、それをビルドできるエージェントがないときに通知を送信します。 |
プランまたはジョブから通知を削除
プランに対する「編集」権限を持っていると、通知を追加または削除することができます。
- 「プランの設定」に記載されているように、目的のプランの設定に移動します。
- [通知] タブをクリックします。
- 削除する各通知の [削除] をクリックします。