通知ルールの追加
この記事では、通知ルールを設定する方法について説明します。TeamCity サーバーで通知機能を有効にする方法については、次の手順に従ってください。
各通知ルールは、監視されるスコープと通知をトリガーするイベントの 2 つの部分で構成されます。ユーザーは、個人ルールを作成し、ユーザーグループからルールを継承できます。
通知ルールを追加
新しい個人通知ルールを追加するには:
画面の右上隅にあるアバターをクリックし、ドロップダウンメニューのプロファイルをクリックします。
プロファイルで、通知ルールタブを開きます。
必要な通知タイプをクリックして、必要な設定を構成します。
新しいルールを追加をクリックし、ダイアログでルールを指定します。
何が監視されます
以下のプロジェクトおよびビルド構成に関連するイベント | ビルドを監視したいプロジェクト / ビルド構成を選択します。プロジェクトに定義された通知ルールはそのサブプロジェクトに伝播されます。すべてのプロジェクトのビルド構成のすべてのビルドをモニターするには、ルートプロジェクトを選択してください。 選択したプロジェクト / ビルド構成内の通知を細かく制御するには、以下のオプションを使用します。
|
システム全体のイベント | 割り当てられた調査について通知を受けるように選択します。 |
通知をトリガーするイベント
ビルドが失敗する | このオプションをオンにすると、指定したプロジェクトおよびビルド構成で完了した失敗したビルドすべてに関する通知を受け取ります。ビルドの進行中にビルド構成の調査が誰かに割り当てられた場合、失敗したビルドの通知はそのユーザーにのみ送信されます。 ウォッチエリアで変更だけでビルドが選択されている場合、TeamCity はあなたの変更を伴うビルドが失敗した場合に通知し、その後成功したビルドまで各「未完了」ビルドで通知を送り続けるでしょう。不完全ビルドは、次のエラーのうちの少なくとも 1 つで失敗した完成ビルドです。
|
成功後、最初に失敗したビルドについてのみ通知する | このオプションをオンにすると、ビルドが成功した後に最初に失敗したビルドのみ、または変更を加えた最初のビルドについて通知されます。このオプションを使用すると、その後の失敗したビルドについて通知されません。 |
新しいビルドの問題または新しい失敗したテストについてのみ通知する | このオプションをオンにすると、ビルドが新しいビルドの問題または新しい失敗したテストで失敗した場合にのみ通知されます。 |
ビルドは成功しました | 指定したプロジェクトとビルド構成のビルドが正常に実行されたときに通知を受け取るには、このオプションをオンにします。 |
失敗後、最初に成功したビルドについてのみ通知します。 | このオプションをオンにすると、ビルドが失敗した後、最初のビルドが成功した場合にのみ通知を受け取ります。それ以降のビルドが成功した場合の通知は送信されません。 |
最初のエラーが発生しました | 最初のビルドエラーが検出されるとすぐに(ビルドが完了する前であっても)「失敗した」ビルドに関する通知を受け取るには、このオプションをオンにします。 |
キューに入れられたビルドには承認が必要です | 承認が必要なビルドに関する通知を受け取るには、このオプションをオンにします。このオプションは、変更だけでビルドオプションをオーバーライドします。 |
ビルドが始まります | ビルドが開始されたらすぐに通知を受け取るにはこのオプションをチェックしてください。 |
ビルドが起動しない | ビルドの開始に失敗した場合に通知を受け取るには、このオプションをオンにします。 |
ビルドはおそらくハングしている | TeamCity がビルドがハングしていると識別したときに通知を受信するには、このオプションをオンにします。 |
調査が更新されました | このオプションをチェックすると、ビルド設定の変更やテスト調査のステータスの変更に関する通知を受け取ることができます。誰かが問題を調査しているか、問題が解決されたか、調査担当者が変更されました。 |
テストはミュートまたはミュート解除 | 影響を受けるビルド構成でテストミュートステータスの変更に関する通知を受信するには、このオプションをオンにします。 |
割り当てられた調査 | このオプションは、ウォッチ領域でシステム全体のイベントオプションが選択されている場合にのみ使用可能です。問題の調査を開始するたびに通知されるオプションをチェックしてください。 |
ルール処理順序
TeamCity は、通知ルールを提示された順序で適用します。TeamCity は、ビルドがいずれかの通知ルールに一致するかどうかを確認し、最初に一致したルールに従って通知を送信します。同じビルドの一致条件のさらなるチェックは実行されません。構成された通知ルールの順序を変更できます。
ユーザー規則が最初に適用され、次にグループ規則が適用されます。
グループルールは、子グループから親グループへと階層順に処理されます。
独自のルールが設定された親が複数ある場合、継承されたルールは、通知ルールユーザープロファイルタブに表示される順序に対応して上から下に処理されます(アルファベット順)。
既存のルールの購読解除と上書き
自分が所属しているユーザグループに対して、システム管理者によって通知ルールがすでに設定されている場合があります。
グループ通知の購読を解除または上書きするには、同じ監視対象ビルドと異なる通知イベントを使用して独自のルールを追加します。
すべてのイベントの購読を中止するには、対応する監視対象ビルドを含むルールを追加し、イベントを選択しないでください。
関連ページ:
通知の構成
TeamCity は、さまざまなイベントについてユーザーに通知できます。Web ブラウザー、メール、Slack 経由、IDE、この記事では、TeamCity で通知がどのように機能するかを説明し、サーバーで通知を設定する方法を示します。通知レベル:TeamCity の通知は次のように構成できます。ユーザーごと通知ルールは、ユーザープロファイル設定で構成されます。これらのルールはユーザーグループレベルでも設定できるため、グループ内のすべてのユーザーに適用されます。ユーザーレベルの通知ルールは、特...
ブランチフィルター
VCS ルートにブランチが指定されている場合、TeamCity のさまざまな操作でブランチフィルターオプションが使用できるようになります。ブランチフィルターの使用箇所:現在、ブランチフィルターは、次の TeamCity 設定ページで構成できます。ビルド構成のバージョン管理設定ビルド構成に使用できるブランチのセットを制限します。このブランチフィルターは、他のブランチフィルターの前に適用され、カスタムビルドダイアログに表示されるブランチ、およびトリガーとビルドフィーチャーに表示されるブランチを制限...
ユーザーの作成と管理
TeamCity のユーザーアカウントとは:ユーザーアカウントは、ユーザー名とパスワードの組み合わせで、TeamCity ユーザーがサーバーにサインインしてその機能を使用できるようにします。ユーザーアカウントは、使用される認証スキームに応じて手動で作成することも、サインイン時に自動的に作成することもできます (詳細については、認証モジュールセクションを参照してください)。各ユーザーアカウント: 対応する権限を通じてすべてまたは特定の TeamCity 機能へのアクセスを保証する関連するロールがあ...
ビルドの主なアクション
この記事では、TeamCity のビルドに適用できるアクションについて説明します。ビルド実行:TeamCity では、ビルドを実行できます。自動的に、さまざまなビルドトリガーを使用します。手動で、オンデマンド。ビルドを手動で実行するには、画面の右上隅にある実行をクリックします。このアクションは、編集モードと表示モードモードの両方で使用できます。特定のビルド構成で実行ボタンが表示されない場合は、そのビルド構成でビルドを開始するための権限が不足していることを意味します。実行ボタンの横にあるコンテキ...
ビルド状態
プロジェクトページのビルド構成の拡大表示に、ビルド状態アイコンが各ビルドの横に表示されます。構築国:正常に実行ビルドは正常に実行されています。成功指定されたすべてのビルド構成でビルドが正常に終了しました。実行中および失敗ビルドが失敗しています。失敗少なくとも 1 つの指定されたビルド構成でビルドが失敗しました。キャンセルビルドは取り消されました。キャンセル / 中止ビルド実行中のビルドを停止すると、ビルドステータスがキャンセル済みとして表示されます。実行中のビルドは、
ビルドとテストの失敗への対処
ビルドの実行中、通常、次のいずれかの種類の障害が発生する可能性があります。テストの失敗 - ビルド中に試行されたユニットテストまたは機能テストの失敗。ビルドの問題 - ビルド中に発生したその他の問題: リモートリポジトリにアクセスできない、ビルドアーティファクトの取得またはアップロードに失敗する、コンパイルエラーなど。ビルドの問題を表示:TeamCity では、ビルドの問題を検出して調査する方法が複数あります。ビルド結果ページビルド結果ページには、この個々のビルド実行に関する最も詳細な情報が表示さ...