This is the documentation for Bamboo 5.5. View this page for the

Unknown macro: {spacejump}

of Bamboo, or visit the latest Bamboo documentation.

Notifications in Bamboo are triggered by a range of events involving a plan and its jobs, including build completion, build outcomes and comments being posted against build results. You can configure whether notifications are sent for a particular event and who they are sent to. Users can choose whether to receive their notifications via email, IM, both or neither.

For each plan or job, you can specify different recipients for each type of event notification. Also be aware that these recipients do not require

Bamboo Server user accounts.

プランやジョブの通知を追加する

始める前に

On this page:

関連ページ

  • You must have the 'Edit' permission for a plan, to add or remove notifications for it.
  • 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.

プランやそのジョブの通知を追加するには、次の手順に従います。

  1. Navigate to the configuration for the desired plan, as described on Editing a plan's configuration.
  2. Click the Notifications tab.

  3. [Add Build Notification (ビルド通知を追加)] セクションに新しい通知を次のように設定します。

    設定注意
    イベントSelect the event type you want to be notified about. Refer to the list of events (below) for details.
    受信タイプ     ユーザー — 該当する Bamboo ユーザーのユーザー名を入力するか、アイコンをクリックしてユーザーのリストから選択します。

    Hipchat — Enter the Hipchat API Token and Room Name. See Integrating Bamboo with HipChat for more information.

    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 related

      IM responses.

       

       

    • 既存の Bamboo ユーザーの IM アドレスを指定すると、ユーザー設定で通知を受け取らないように選択していても、ユーザーは通知を受け取ります。
    Responsible Users — The Bamboo users who have been assigned as being responsible for a broken build. See Assigning responsibility for build failures.
    コミッター — ビルドが最後に Bamboo によってチェックアウトされてから、特定のビルドにコードをコミットした Bamboo ユーザー。
    Watchers — The Bamboo users who have marked this plan as one of their favourites.
  4. [追加] をクリックしてから、必要に応じてさらに通知を設定します。
  5. 完了したら、[保存] をクリックします。

スクリーンショット: プラン ビルド通知


通知イベント

プラン イベント

説明

すべてのビルドが完了

Bamboo will send a notification whenever the plan build finishes, regardless of the plan build's result. This notification is recommended for any plans whose latest build activity is critical for people to be informed about.
(tick) This is a good plan-based notification to use if you are new to Bamboo. You can change it to a less obtrusive notification option as you become more confident with continuous integration and Bamboo's build processes.

ビルド ステータスの変更

Bamboo will send a notification only when there has been a change in status of the plan's build activity over consecutive plan builds — for example, only whenever a plan's latest build changes from successful to failed or vice versa (i.e. 'fixed').
(tick) This notification option is less obtrusive than the other plan notifications mentioned above.

ビルドが失敗した後に初めて成功Bamboo will send a notification whenever:
- a build of this plan fails.
- the plan is 'fixed' (that is, the plan's latest build is successful and the previous plan build failed).
(tick) This notification is generally suitable for the majority of plans.

X 回のビルド失敗後

This notification allows you to specify the Number Of Failures (i.e. number of failed builds of this plan), after which Bamboo will send a notification.
(tick) This notification option minimises the number of messages sent by Bamboo if the plan's builds fail on a frequent basis. You can also use this event to escalate plan build problems, for example, to notify a manager when a plan build fails five times.

コメント追加時

Bamboo will send a notification whenever a comment is posted against a plan build result. The email notification will contain all comments against the plan build, whereas IM notifications will only contain the comment that triggered this notification event.
(tick) This notification can help improve collaboration between team members. Be aware that you will not receive notifications for any comments which you post yourself.

責任の変更

Bamboo will send a notification whenever someone is added to, or removed from, the list of those responsible for a broken build.
(tick) This notification can help improve collaboration between team members.

ジョブ イベント

 

すべてのジョブが完了

Bamboo will send a notification whenever a job build of the plan finishes, regardless of the job build's result. This notification is recommended if the latest build activity of all jobs in this plan are critical for people to be informed about.
(tick) This is a good job-based notification to use if you are new to Bamboo. You can change it to a less obtrusive notification option as you become more confident with continuous integration and Bamboo's build processes.

ジョブ ステータスの変更

Bamboo will send a notification only when there has been a change in build activity status of the jobs within this plan over consecutive plan builds — for example, only whenever the latest build of any job in this plan changes from successful to failed or vice versa (i.e. 'fixed').
(tick) This notification option is less obtrusive than the other job notifications mentioned above.

失敗したジョブと最初の成功Bamboo は次の場合に必ず通知を送信します。
- このジョブのビルドに失敗した。
- ジョブが「修正」された (つまり、ジョブの最新のビルドは成功し、前のジョブのビルドは失敗)。

プランで最初に失敗したジョブ

If multiple jobs fail in a plan, Bamboo will only send a notification for the first failing job detected by the Bamboo system.
(tick) This is a less obtrusive notification option that informs about a failing job (and hence, plan) in the shortest possible time.

ジョブ エラー

Bamboo は、プランのジョブ ビルド プロセス (つまり、Bamboo がジョブ ビルドを実行するために行うアクティビティ) のいずれかでエラーが発生するたびに通知を送信します。このイベントは、実際のビルド自体の失敗とは関係ありません (上記のイベント「失敗したジョブと最初の成功」と「失敗したビルドと最初の成功」を参照してください)。例えば、リポジトリの接続時や変更の検出時に Bamboo でエラーが発生した場合、通知が送信されます。

ジョブのハング

Bamboo will send a notification whenever it determines that one of the plan's job builds has hung, according to the hung job build criteria (read more about configuring your hung job build settings).
(tick) Use this notification to ensure that the relevant people are informed when a job build becomes unresponsive.

ジョブ キューのタイムアウト

Bamboo will send a notification whenever one of the plan's job builds has been waiting in the queue for longer than the build queue timeout criteria (read more about configuring your job's Build Queue Timeout settings).
(tick) Use this notification to ensure that the relevant people are informed when a job build is stuck in the build queue for too long.

ビルドできるエージェントがない状態でジョブをキューに登録

Bamboo will send a notification whenever one of the plan's job builds is queued and there are no agents capable of building it.
(tick) Use this notification to ensure that people are notified when changes to agents adversely affect your job's builds.

プランまたはジョブから通知を削除

始める前に

To remove notifications for a plan or its jobs:

  1. Navigate to the configuration for the desired Plan, as described on Editing a plan's configuration.
  2. [通知] タブをクリックします。
  3. 削除する各通知の [削除] をクリックします。

 

 

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.