TeamCity 2019.1ヘルプ

ビルド結果を扱う

TeamCityでは、ビルドにはいくつかの状態があります。

  • 何らかのイベントが発生すると、ビルドトリガーはビルドをキューに追加し、そこでビルドはフリーエージェントを待機します。

  • エージェントでビルドが開始され、構成されたすべてのビルド手順が実行されます。

  • ビルドが終了し、このビルド構成のビルド履歴の一部になります。

TeamCityでは、キューに入っているか、実行中か、または終了したかにかかわらず、特定のビルドに関するすべての情報がビルド結果ページに蓄積されます。このページには、ビルド番号またはビルドステータスのリンクをクリックしてアクセスできます。

ビルド情報を提供するだけでなく、このページでは以下のことが可能です。

このページで:

ビルド詳細

ビルド結果ページには、ビルド構成のホームページにアクセスしたり、TeamCity Web UIのさまざまな場所からアクセスして、ビルド番号またはビルド状況をリンクとして表示することができます。ビルドが完了した後にのみアクセス可能なデータもありますが、変更ビルドパラメータ依存関係などの詳細は、キューで待機している間もビルドに適用されます。

このページで利用可能なビルド情報は以下のセクションで説明されています。

ビルドステップとして有効になっているビルドランナーに応じて、ページ上のタブの数と概要タブの情報は異なる場合があります。

ビルドの概要

概要タブには、ビルド期間、使用されたエージェント、トリガー、依存関係など、ビルドに関する一般的な情報が表示されます。ビルドがキューに入れられている場合、タブにはキュー内のビルドの位置、ビルドの開始予定時刻などが表示されます。

ビルドが実行中の場合は、タブにビルドの進行状況が表示されます。概要タブの対応するリンク、またはアクションボタンのドロップダウンから適切なオプションを使用して、実行中のビルドを停止することもできます。

これと同じビルド構成の別のビルドが同時に実行されている場合は、概要タブに次の情報を含む小さなウィンドウが表示されます。

  • ビルド結果ページにリンクしているそのビルドのビルド結果

  • そのビルドに含まれる変更のドロップダウンリストを含む変更リンク

  • ビルド番号、開始時刻、およびそれが実行されているエージェントへのリンク。

ビルドがハングしている可能性がある場合は、対応する通知が概要タブの上部に表示されます。この場合、TeamCityは実行中のビルドのプロセスツリーと各Javaまたは.NETプロセスのスレッドダンプを別々のフレームに表示するためのリンクを提供します。プロセスがJavaでも.NETでもない場合は、そのコマンドラインが取得されます。スレッドダンプを表示する可能性は、次のプラットフォームでサポートされています。

  • Windows、JDK 1.3以上

  • Windows、JDK 1.6-1.8、jstackユーティリティ使用

  • Windows以外、JDK 1.5-1.8、jstackユーティリティ使用

タブの情報は、有効になっているビルドランナーによって異なります。設定されている場合、コードカバレッジのまとめと完全レポートへのリンク、コード内に見つかった重複数、および重複タブを開くリンクなどが表示されます。コード・カバレッジ重複タブの詳細については、以下のセクションを参照してください。

ビルドに問題があった場合は、概要タブにもそれらが表示されます。

ビルドがテストに失敗した場合、ビルド結果ページの概要タブで見ることができます。

テスト

このビルドで成功または失敗したテストがある場合は、それが概要タブに表示されます。

失敗したテストごとに、スタックトレース、期待値と実際の値の差、テスト履歴へのジャンプ、失敗を調査するチームメンバーの割り当て、 IDEでテストを開く、またはすぐに修正を開始することができます。

ビルドに関連するすべてのテストを表示するには、専用のテストタブを使用してください: さらに学習したい方に

変更

変更タブから、次のことができます。

  • ビルドに含まれるすべての変更とそれに対応するバージョン管理の改訂を確認する
    • 現在のビルドが依存しているビルドに含まれている変更を確認します。現在のビルド構成に成果物依存関係があり、現在のビルドでダウンロードされた成果物が現在の構成の前のビルドでダウンロードされたものと比べて変更されている場合、成果物の依存関係の変更ノードそこから成果物依存関係をダウンロードするために使用されたビルド、およびそのビルドに含まれていた変更を表示して表示されます。

  • ビルドソースにラベルを付ける (TeamCity 8.1より前)

  • ビルド構成のVCS設定を構成する(十分な権限がある場合)。

このページの変更ごとに、次のことができます。

  • 詳細の変更を調べる

  • オプションを有効にして「スナップショットの依存関係からの変更の表示」、変更元の依存ビルド、またはスナップショット依存関係を使用してビルドする依存ビルドを表示します (TeamCity 2017.1以降)link.png アイコンの上にカーソルを置くと、依存ビルドの番号が表示されます。リンクをクリックすると依存するビルドの変更タブが開きます。

  • 変更されたファイルリンクをクリックして詳細を変更に移動する

  • この変更によるカスタムビルドを開始する

  • パッチをダウンロードする

  • IDEにパッチをダウンロードする

  • 管理者が設定している場合は、外部の変更ビューアーで変更を確認します。

変更タブは、変更リストに対する高度なフィルタリング機能を提供します。グラフの表示を有効にすると、このビルドに関連するVCSルートへのコミットのグラフとして変更が表示されます。

グラフはリストの左側に表示され、可変レベルの詳細を使用して変更のビューを表示できます: できます:

  • このビルドで変更されたVCSルートを表示します。各ルートはバーとして表されています。

  • グラフノードに移動して、VCSルートリビジョン番号を表示します。

  • バーをクリックして単一のVCSルートを選択します。このルートに関係しない変更はグレー表示されています。

  • リポジトリのブランチ間にマージがあると、グラフにそれらが表示されます。バーを折りたたむには、バーの暗い部分に移動してクリックし、結合の履歴を非表示にします。点線は、バーが拡張可能であることを示します。

  • VCSルートにサブリポジトリ(変更リストでSとマークされている)がある場合は、親のノードに移動して、サブリポジトリのどのコミットが親のこのリビジョンによって参照されているかを確認します。

ファイルの表示ボックスをチェックして、変更されたファイルを表示するように選択できます。ファイル名をクリックすると差分ビューアーが開きます。

すべてのテスト

特定のビルドのすべてのテストを表示するには、ビルド結果ページを開き、テストタブに移動します: このページで:

項目

説明

すべてのテストをCSVでダウンロードする

リンクをクリックして、すべてのビルドテスト結果を含むファイルをダウンロードしてください。

フィルタリングオプション

この領域を使用してテストリストをフィルタリングします。

  • 表示する項目の種類を選択します:テスト、スイート、パッケージ/名前空間、またはクラス。

  • 文字列(リストからのテスト名など)を入力して、リストの範囲を変更します。

  • テストステータスを選択してください。

表示

ページに表示するテストの数を選択してください。

状況

テストのステータス(OK、無視、および失敗)を表示します。失敗したテストは赤い失敗リンクとして表示され、クリックするとテスト失敗の詳細を表示および分析できます。この列の上のヘッダをクリックして、ステータス別にテーブルをソートします。

テスト

クラス、名前空間/パッケージ、またはスイートの名前をクリックすると、その中に含まれている項目のみが表示されます。テスト名の横にある矢印をクリックしてテスト履歴を表示するか、ビルドログでテストを開くか、失敗したテストの調査を開始するか、またはIDEで失敗したテストを開きます。

持続時間

テストが完了するまでにかかった時間を示します。このアイコン StatsIcon.pngをクリックすると、下記のテスト期間グラフを表示できます。

順序

テストが実行された順序を示します。この列の上のヘッダーをクリックして、テストオーダー番号でソートします。

テスト・ヒストリー

To navigate to the history of a particular test, click the arrow next to the test name and select テスト・ヒストリー from the drop-down menu.
There are several places where tests are listed and from where you can open Test History.
For example:

  • プロジェクトホームページ | 現在の問題タブ

  • プロジェクトホームページ | 現在の問題タブ | 問題のあるテスト

  • ビルド結果ページ | 概要タブ

  • ビルド結果ページ | テストタブ

  • プロジェクト | <失敗したテストを含むビルド> | ビルド結果ドロップダウン

テスト・ヒストリーリンクをクリックするとテスト詳細ページが開き、以下の情報が表示されます。

  • テストの成功率とテストの実行期間のデータを含むテスト詳細セクション:

  • テスト期間グラフ詳細については、下記のテスト期間グラフの説明を参照してください。

  • テストのステータス、期間、およびこのテストが実行されたビルドに関する情報を含む完全なテスト履歴テーブル。

テスト期間グラフ

テスト期間グラフ(上のスクリーンショットを参照)は、このビルド構成のビルドで個々のテストが実行されるのにかかる時間を比較できます。

テスト期間の結果は、現在ビルド履歴にあるビルドに対してのみ使用可能です。ビルドがクリーンアップされると、このデータは利用できなくなります。

テスト期間グラフでは、次の操作を実行できます。

  • 表示に失敗しましたオプションをオフにして、テストに失敗したビルドを除外します。

  • 平均オプションを選択して日平均値を計算します。

  • グラフ上にプロットされた点をクリックすると、対応するビルドの結果を含むページにジャンプします。

  • グラフ上のドットのツールチップでビルドサマリーを表示し、対応するビルド結果ページに移動します。

  • エージェントが特定のエージェントを選択または消去するか、またはすべてまたはなしリンクをクリックしてすべてのエージェントを選択または消去することによって、情報をフィルタリングします。

ビルドログ

ビルドごとに、ビルドログを表示およびダウンロードできます。TeamCityのビルドログに関する詳細はこちらをご覧ください。

パラメーター

特定のビルドで使用されたすべてのシステムプロパティーと環境変数は、ビルド結果ページのパラメータータブに一覧表示されています: ビルドパラメータの詳細

報告された統計値ページには、ビルドについて報告された統計値が表示され、トレンドを見るアイコン ViewTrend.PNGをクリックすると、各値の統計グラフが表示されます。

依存関係

完成したビルドに成果物および/またはスナップショットの依存関係がある場合は、依存関係タブがビルド結果ページに表示されます。ここでは、このビルドの作成に成果物やソースが使用されたビルド(ダウンロード済み成果物)、および現在のビルドの成果物やソースを使用したビルド(配信成果物)を調べることができます。さらに、ビルドに対する間接的な依存関係を表示できます。つまり、たとえば、ビルドAがビルドBに依存し、ビルドBがビルドCおよびDに依存している場合、これらのビルドCおよびDはビルドAに対する間接的な依存関係になります。

関連課題

課題トラッカーとの統合が設定されていて、含まれている変更のコメントまたはビルド自体のコメントに少なくとも1つの課題が記載されている場合は、課題の現在のビルドに関連する課題のリストが表示されます。タブ。

ビルド成果物

ビルドによって成果物が生成された場合は、それらすべてが専用の成果物タブに表示されます。

コードカバレッジ結果

ビルドランナーでコードカバレッジを設定している場合は、完全なHTMLコードカバレッジレポートを含む専用のタブがビルド結果ページに表示されます。

カバレッジ内訳セクションのリンクをクリックすると、名前空間、アセンブリ、メソッド、ソースコードなど、さまざまなスコープの統計を表示するためにドリルダウンできます。

コード・インスペクション結果

設定されている場合、コード・インスペクションビルドステップの結果はコード・インスペクションタブに表示されます。左ペインを使用してインスペクションの結果をナビゲートします。フィルタ処理されたインスペクションが右ペインに表示されます。

  • 警告に興味がなければ、合計からエラーオプションに切り替えてください。

  • スコープフィルタを使用して、ビューを特定のディレクトリーに限定します。これにより、開発者は関心のある特定のコードを管理しやすくなります。

  • スコープフィルタのインスペクションツリービューを使用して、特定のインスペクションによる結果を表示します。

  • TeamCityが問題を含むソースコード行番号を表示するように注意します。IDEのコードにジャンプするには、それをクリックしてください。

重複

ビルド構成にビルドステップの1つとしてDuplicatesビルドランナーがある場合、ビルド結果に重複タブが表示されます。

タブは次のもので構成されています。

  • 重複のリストが見つかりました。新しい唯一のオプションを使用すると、最新のビルドに表示された重複のみを表示できます。

  • これらの重複を含むファイルのリスト。左右の矢印ボタンを使用して、選択した複製をタブの下部のそれぞれのペインに表示します。

  • 重複を含むファイルフラグメントのソースコードを含む2つのペイン。

  • 左上隅のスコープフィルタは、重複を含む特定のディレクトリーを一覧表示します。このフィルタリングにより、開発者は目的のコードを管理しやすくなります。

Mavenビルド情報

Mavenのビルドごとに、TeamCityエージェントはMaven固有のビルド詳細を収集します。詳細は、ビルドが完了した後にビルド結果のMavenビルド情報タブに表示されます。

内部ビルドID

ビルド結果ページのURLには、数値を持つパラメーター buildId があります。この番号は、TeamCityインストールでビルドを一意に識別する内部ビルドIDです。URLを手動で作成するときにこのIDが必要になる場合があります。たとえばREST APIの場合、成果物をダウンロードします


関連事項:

概念 : ビルドログ | ビルド成果物 | 変更 | コード・カバレッジ
使用説明書 : ビルド障害の調査とミュート | テストと設定の問題の表示
管理者ガイド : ビルド構成の作成と編集


関連ページ:

カスタムビルドを開始する

通常、ビルド構成には、スケジュールされた時間やVCSの変更の検出など、条件が満たされるたびに新しいビルドを自動的に開始するように構成されたビルドトリガーがあります。TeamCityを使用すると、自動的にビルドを開始するだけでなく、必要に応じて手動でビルドを実行したり、プロパティーを追加したり、特定の...

ビルド構成の作成と編集

このページでは、TeamCity Web UIを使用したビルド構成の作成について詳しく説明しています。他のオプションには、REST APIおよびKotlin言語に基づくDSLでのTeamCityプロジェクト構成の使用が含まれます。このページで:手動で新しいビルド構成を作成する、URLから新しいビルド...

TeamCityと課題追跡システムの統合

TeamCityを課題トラッカーと統合して、開発プロジェクトの包括的なビューを提供できます。TeamCityは、バージョン管理の変更に対するコメントに記載されている課題を検出し、TeamCity Web UIの課題トラッカーへのリンクに変換します。統合はプロジェクトレベルで設定されます。プロジェクト...

REST API

一般情報一般的な使用箇所、REST認証、スーパーユーザーアクセス、REST APIのバージョン、URLの構造、ロケーター、サポートされているHTTPメソッド、応答フォーマット完全および部分的な回答、ロギング、CORSのサポート、APIクライアントの推奨事項、TeamCityデータエンティティ要求プロ...

テストと設定の問題の表示

このページで:プロジェクト概要ページでの問題の表示、現在の問題タブを使用する、不安定なテスト、プロジェクト概要ページでの問題の表示:プロジェクト概要ページには、ビルド構成で失敗したテストの数やその他の問題も表示されます。問題のあるビルド構成のデータが展開されていない場合、テスト番号のリンクをクリック...