通知ルールの追加
この記事では、通知ルールを設定する方法について説明します。 TeamCity サーバーで通知機能を有効化する方法については、 こちらの手順に従ってください。
各通知ルールは、 ウォッチされるスコープと 通知をトリガーするイベントの 2 つの部分で構成されます。 ユーザーは、個人ルールを作成し、ユーザーグループからルールを継承できます。
通知ルールを追加
新しい個人通知ルールを追加するには:
画面の右上隅にあるアバターをクリックし、ドロップダウンメニューの プロファイリング をクリックします。
プロフィール で、 通知ルール タブを開きます。
必要な通知タイプをクリックして、必要な設定を構成します。
新しいルールを追加 をクリックし、ダイアログでルールを指定します。
ウォッチ対象
以下のプロジェクトおよびビルド構成に関連するイベント | ビルドを監視したいプロジェクト / ビルド構成を選択します。 プロジェクトに定義された通知ルールはそのサブプロジェクトに伝播されます。 すべてのプロジェクトのビルド構成のすべてのビルドをモニターするには、 ルートプロジェクト を選択してください。 選択したプロジェクト / ビルド構成内の通知を細かく制御するには、以下のオプションを使用します。
|
システム全体のイベント | 割り当てられた調査について通知を受けるように選択します。 |
通知をトリガーするイベント
ビルドが失敗する | このオプションをオンにすると、指定したプロジェクトおよびビルド構成で 完了した失敗したビルドすべてに関する通知を受け取ります。 ビルドの進行中にビルド構成の調査が誰かに割り当てられた場合、失敗したビルドの通知はそのユーザーにのみ送信されます。 ウォッチ エリアで 自分の変更を含むビルドのみ が選択されている場合、変更を含むビルドが失敗すると TeamCity が通知し、その後は成功するビルドが実行されるまで、各 '未完了' ビルドについて通知を送り続けます。 不完全ビルドは、次のエラーのうちの少なくとも 1 つで失敗した完成ビルドです。
|
成功後、最初に失敗したビルドについてのみ通知する | このオプションをオンにすると、ビルドが成功した後に最初に失敗したビルドのみ、または変更を加えた最初のビルドについて通知されます。 このオプションを使用すると、その後の失敗したビルドについて通知されません。 |
新しいビルドの問題または新しい失敗したテストについてのみ通知する | このオプションをオンにすると、ビルドが新しいビルドの問題または新しい失敗したテストで失敗した場合にのみ通知されます。 |
ビルドは成功しました | 指定したプロジェクトとビルド構成のビルドが正常に実行されたときに通知を受け取るには、このオプションをオンにします。 |
失敗後、最初に成功したビルドについてのみ通知します。 | このオプションをオンにすると、ビルドが失敗した後、最初のビルドが成功した場合にのみ通知を受け取ります。 それ以降のビルドが成功した場合の通知は送信され ません。 |
最初のエラーが発生する | 最初のビルドエラーが検出されるとすぐに(ビルドが完了する前であっても)「失敗した」ビルドに関する通知を受け取るには、このオプションをオンにします。 |
キューに入ったビルドに承認が必要 | 承認が必要なビルドに関する通知を受け取るには、このオプションをオンにします。 このオプションは、 自分の変更を含むビルドのみ オプションをオーバーライドします。 |
ビルドが開始する | ビルドが開始されたらすぐに通知を受け取るにはこのオプションをチェックしてください。 |
ビルドの開始に失敗する | ビルドの 開始に失敗した場合に通知を受け取るには、このオプションをオンにします。 |
ビルドがハングしている可能性がある | TeamCity がビルドを ハングしていると識別したときに通知を受信するには、このオプションをオンにします。 |
調査が更新される | ビルド構成またはテスト調査のステータスが変更されたときに通知を受信するには、このオプションをオンにします。たとえば、誰かが問題を調査している、問題が修正された、調査担当者が変更された場合などです。 |
テストがミュートまたはミュート解除される | 影響を受けるビルド構成でテスト ミュートステータスの変更に関する通知を受信するには、このオプションをオンにします。 |
自分に割り当てられた調査 | このオプションは、 ウォッチ 領域で システム全体のイベント オプションが選択されている場合にのみ使用可能です。 問題の調査を開始するたびに通知されるオプションをチェックしてください。 |
ルールの処理順序
TeamCity は、表示されている順序で通知ルールを適用します。 TeamCity はビルドが通知ルールのいずれかに一致するかを確認し、 最初に一致したルールに従って通知を送信します。同じビルドに対する一致条件の以降の確認は実行されません。 構成済みの通知ルールの順序を変更できます。
ユーザー規則が最初に適用され、次にグループ規則が適用されます。
グループルールは、子グループから親グループへと階層順に処理されます。
独自のルールが設定された親が複数ある場合、継承されたルールは、通知ルールユーザープロファイルタブに表示される順序に対応して上から下に処理されます(アルファベット順)。
購読解除と既存ルールのオーバーライド
自分が所属しているユーザグループに対して、システム管理者によって通知ルールがすでに設定されている場合があります。
グループ通知の購読を解除または上書きするには、同じ監視対象ビルドと異なる通知イベントを使用して独自のルールを追加します。
すべてのイベントの購読を中止するには、対応する監視対象ビルドを含むルールを追加し、イベントを選択しないでください。