TeamCity 2019.2ヘルプ

ビルド障害の調査とミュート

何らかの問題やテストの失敗が原因でビルドが失敗した場合、TeamCityを使用すると、ビルドエラーの調査を特定のユーザーに割り当てたり、ビルドステータスに影響を与えないように失敗ミュートしたりできます。

失敗したビルド構成全体の調査を割り当てるか、単一のビルドの問題と失敗したテストを調査/ミュートできます。調査/ミュート機能は、ビルドの問題と失敗したテストに対して同じように機能します。

このページで:

必須アクセス権

特定のプロジェクトで調査/ミュートを管理および表示できるようにするには、このプロジェクトで次の権限が付与されている必要があります。

  • ミュートを管理するための「プロジェクトの問題をミュート/ミュート解除する

  • 調査を管理するための「調査の割り当て/割り当て解除

  • 調査/ミュートを表示するための「プロジェクトとすべての親プロジェクトを表示する

これらの権限は、デフォルトでプロジェクト管理者とシステム管理者に付与されます。

失敗したビルド構成の調査の割り当て

失敗したビルド構成の調査を割り当てるには:

  1. ビルド構成ホームページの概要タブ(またはビルド結果ページの概要タブ)に移動し、調査を割り当てるをクリックします。

    Assign an investigation of a failed build

  2. 調査対象ドロップダウンメニューからTeamCityユーザーを選択します。

    Assigned an investigation of a failed build

  3. 調査を解決する条件を選択します。
    • ビルド構成が成功したとき
    • または、手動;このモードは、「成功」ビルドステータスが問題が解決されたことを直接示していない場合に、不安定なテストを使用したビルド構成に推奨されます。
      調査が割り当てられたユーザーは、後でこのウィンドウで問題を修正済みとしてマークできます。

  4. 調査を保存します。

同じプロジェクトの他の失敗したビルド構成に同様の調査を割り当てるには、詳細 をクリックして、リストで構成を選択します。

Assign more investigations in the project

ビルドの問題と失敗したテストの調査の割り当て

特定のビルド問題の調査を割り当てるには:

  1. ビルド結果ページの概要タブ(またはプロジェクトホーム現在の問題タブ)に移動し、ビルドの問題の横にある矢印をクリックしてから調査/ミュートをクリックします。

    Investigate/mute a build problem

    調査/ミュートダイアログが開きます。

  2. 調査対象ドロップダウンメニューからTeamCityユーザーを選択します。

    Assigned an investigation of a failed build

  3. 調査を解決する条件を選択します。

    調査が割り当てられたユーザーは、後でこのウィンドウで問題を修正済みとしてマークできます。

  4. 調査を保存します。

同様に、ビルド結果概要またはテストタブで、失敗したテストの調査を割り当てることができます。

ビルドの問題をミュートする

特定のビルドの問題をミュートするには:

  1. ビルド結果ページの概要タブ(またはプロジェクトホーム現在の問題タブ)に移動し、ビルドの問題の横にある矢印をクリックしてから調査/ミュートをクリックします。
    調査/ミュートダイアログが開きます。

  2. 問題をミュートする場所を選択します。
    • プロジェクト全体は、現在のプロジェクトとそのサブプロジェクトのすべての構成で問題をミュートしています。

    • 選択されたビルド構成。同じプロジェクトから特定のビルド構成を選択できます。

  3. 問題のミュートを解除する条件を選択します。
    • 修正時に自動的に (続きを読む)

    • 特定の日に
    • または、手動

  4. 保存をクリックします。

失敗したテストのミュート

ビルドの問題をミュートすると同様に、ビルド結果概要またはテストタブで、失敗したテストまたは複数のテストを一度にミュートできます

Investigate/mute a build problem

ミュートは、「少なくとも1つのテストが失敗しましたビルド失敗条件で失敗するが、他の条件では失敗するビルドにのみ影響します。他の失敗条件がビルドに適用される場合(たとえば、ゼロ以外の終了コード)、失敗したテストはミュートされます。

この機能は、いくつかのテストが既知の理由で失敗する場合に役立ちますが、現在修正することはできません。例:責任のある開発者がいないか、システム管理者が環境を修正するのを待っています。この機能は、テストが意図的に失敗した場合にも使用できます。たとえば、必要な機能がまだ準備されていない場合です。
これらのすべての場合において、そのような失敗をミュートし、他の開発者の不必要な妨害を避けることができます。

テストがミュートされると、今後のビルドでも実行されますが、テストの失敗はビルドステータスに影響しません。

失敗したがミュートされたテストがあるときにビルドを成功させるために、ビルドスクリプトを調整する必要がある場合があります。発生したエラーがテストの失敗のみであった場合は、他のビルド障害条件(たとえば、「ビルドプロセスの終了コードがゼロでない場合は失敗します」)のためにビルドが失敗しないことを確認してください。詳細については、関連する課題TW-16784(英語)を参照してください。

問題を修正済みとしてマークする

調査が割り当てられたユーザーは、この問題に対応する調査する UIダイアログで調査済みの問題を修正済みとしてマークできます。
問題は、表示されるすべてのTeamCityページで checkmark.png でマークされます。これにより、UIで潜在的に修正された問題を特定できますが、次のビルド実行でも問題が続く場合は調査を続行する可能性が残ります。調査の作成者がそれぞれの通知をオンにしている場合、修正について通知されます。
TeamCityは、問題が再現されず、この調査に「修正時に自動的に」解決条件がある場合、調査が修正済みとしてマークされた後、次のビルド実行で調査を削除します。

調査とミュートの表示

プロジェクトホームページで、プロジェクトごとのすべての調査とミュートを見つけることができます。

  • 調査タブ: プロジェクトで割り当てられたすべての調査を見る

  • ミュート問題タブ: プロジェクト内のすべてのミュートされた問題とテストを見る

Investigations and Muted Problems tabs

ここで、問題とテストのミュートを解除し、調査を別のユーザーに再割り当てするか、修正済みとしてマークすることができます。

調査の表示

1つ以上の調査が割り当てられている場合、TeamCityトップパネルの名前の横に調査カウンターが表示されます。

New investigations

クリックして調査ページを開き、さまざまなプロジェクトで割り当てられたすべての調査を表示できます。このページで問題を直接管理できます:修正済みとしてマーク、再割り当て、ミュート、または調査の放棄。

失敗したテストごとに、すぐに確認できます。

  • テストが現在失敗しているすべてのビルド構成

  • 現在のスタックトレースと、テストが現在失敗しているビルドに関する情報

  • スタックトレースとビルドを含む、テストの最初の失敗に関する情報

プロファイル設定で「変更と調査を強調する」オプションを有効にすると、割り当てられた調査もWeb UIで強調表示されます。

調査およびミュートされた問題の自動修正に関する注意

調査またはミュートオプションで「修正時に自動的に」オプションが選択されている場合、TeamCityは異なるブランチの各障害の状態を分析して、調査を解決するか、より賢くします。

  • デフォルトのブランチおよび別のアクティブなブランチで障害が発生し、これらのブランチのいずれかでこの障害に調査(またはミュート)が割り当てられている場合、障害がデフォルトのブランチで修正されるとすぐに解決されます。

  • デフォルト以外のアクティブブランチで障害が発生した場合、割り当てられた調査(またはミュート)は、それが発生したすべてのアクティブブランチで修正された場合にのみ解決されます。


関連事項:

概念 : ビルド構成ステータス
使用説明書 : テストと設定の問題の表示