ビルド結果ページ
TeamCity では、ビルドに関するすべての情報は、キューに入れられているか、実行中であるか、終了しているかにかかわらず、ビルド結果ページに蓄積されます。このページには、ビルド構成ホームページから、ホームモードで参照しているときに、ビルド番号またはビルドステータスがリンクとして表示される TeamCity UI のさまざまな場所からアクセスできます。一部のデータは、ビルドが終了した後にのみアクセスできます。変更、パラメーター、依存関係などの詳細は、キューで待機しているビルドにも適用できます。
この記事では、新しい TeamCity UI のビルド結果ページの概要を説明します。その機能のほとんどは、クラシック UI モードでも使用できます。
内部ビルド ID
ビルド結果ページの URL には、数値を含むパラメーター buildId
があります。この番号は、TeamCity インストールのビルドを一意に識別する内部ビルド ID です。URL を手動で作成するときに、この ID が必要になる場合があります。例: REST API リクエストの場合、またはビルドアーティファクトをダウンロードする場合。
ビルド結果のタイトルパネル
ビルド結果ページにはいくつかのタブがあり、そのセットは現在のビルドの詳細といくつかの一般的な要素によって異なります。
現在のビルドのブランチを表示するブランチセレクター。ビルド構成ホームの場合、このセレクターを使用すると、表示されているビルドのリストを特定のブランチで実際にフィルタリングできます。
アクションメニュー(ここで説明)。
詳細ブロック: 展開すると、現在のブロックに関する主な情報が表示されます。
このビルドの調査をすばやく割り当てたり、開いている調査の詳細を確認したりできる調査ウィジェット。
以前のすべてのビルドとその詳細を表示するトレンドウィジェット。ビルドにカーソルを合わせると、詳細が表示されます。
概要タブ
概要タブには、ビルド期間、使用されたエージェント、トリガー、依存関係など、ビルドに関する一般的な情報が表示されます。タブのセットは、現在のビルドの手順と詳細によって異なります。ビルドがキューに入れられている場合、タブには、キュー内のビルドの位置、ビルドの開始予定時刻などが表示されます。
![Sakura ビルド結果ページ Sakura Build Results page](https://resources.jetbrains.com/help/img/teamcity/2024.03/exp-build-details.png)
また、現在のビルドのステータスに関連する診断メッセージも表示されます。
変更タブ
変更タブには、ビルドの変更に関する情報が表示され、変更のリストに対する高度なフィルター機能が提供されます。変更を作成者、コメント、パス、リビジョンでフィルタリングできます。
依存関係による変更を表示するには、対応するボックスをチェックします。
ファイルの表示ボックスをチェックすると、変更されたファイルを表示できます。ファイル名をクリックすると、差分ビューアーが開きます。
グラフの表示を有効にすると、このビルドに関連する VCS ルートへのコミットのグラフとして変更が表示されます。グラフはリストの左側に表示され、さまざまな詳細レベルで変更を表示します。これにより、次のことが可能になります。
グラフノードに移動して、VCS ルートリビジョン番号を表示します。
このビルドで変更された VCS ルートを表示します。変更リストの左側の領域にマウスを置くと、各ルートがバーとしてハイライトされます。
バーをクリックして 1 つの VCS ルートを選択します。このルートに関係する変更のみが表示され、その他はグレー表示されます。
リポジトリのブランチ間にマージがあった場合は、グラフにそれらが表示されます。
VCS ルートにサブリポジトリ(変更リストで S とマークされている)がある場合は、親のノードに移動して、サブリポジトリのどのコミットが親のこのリビジョンによって参照されているかを確認します。
変更タブから、次のことができます。
ビルドに含まれるすべての変更と、バージョン管理の対応するリビジョンを確認します。
現在のビルドが依存しているビルドに含まれている変更を確認します。現在のビルド構成にアーティファクト依存関係があり、現在のビルドでダウンロードされたアーティファクトが現在の構成の前のビルドでダウンロードされたものと比べて変更されている場合、アーティファクトの依存関係の変更ノードそこからアーティファクト依存関係をダウンロードするために使用されたビルド、およびそのビルドに含まれていた変更を表示して表示されます。
ビルド構成の VCS 設定を構成する(十分な権限がある場合)。
このページの変更ごとに、次のことができます。
詳細の変更を調べます。
「スナップショット依存関係からの変更を表示」オプションを有効にすると、変更がどの依存ビルドから発生したか、スナップショット依存関係を持つビルドが表示されます。
変更されたファイルのリンクをクリックして、詳細を変更に移動します。
この変更を伴うカスタムビルドを開始します。
パッチをダウンロードします。
パッチを IDE にダウンロードします。
管理者が設定している場合は、外部の変更ビューアーで変更を確認します。
ログの作成タブ
グラフィックビルドログのタイムラインは、各ビルドステージの期間を反映し、ビルドの問題を示します。
![ビルドタイムライン Build timeline](https://resources.jetbrains.com/help/img/teamcity/2024.03/build-timeline.png)
いずれかのステージをクリックして、ビルドログの対応する行を開きます。
TeamCity のビルドログの詳細については、こちらをご覧ください。
アーティファクトタブ
ビルドによってアーティファクトが生成された場合は、それらすべてが専用のアーティファクトタブに表示されます。
パラメータータブ
パラメータータブには、ビルドパラメーターのすべての実際の (このビルド時点での) 値が表示されます。
![ビルドパラメーターレポート Build parameters report](https://resources.jetbrains.com/help/img/teamcity/2024.03/dk-params-newAndUpdated.png)
このページには 2 つのタブがあります。
パラメーター — すべての構成パラメーター、システムプロパティ、環境変数の値をリストします。関連するチェックボックスにチェックを入れると、このビルド中に値が変更されたパラメーターのみを表示できます。
統計値 — ビルドに関して報告されたすべての統計値をリストします (たとえば、ビルドの成功率やリモートリポジトリのチェックアウトに必要な時間など)。グラフの表示ボタン (
) を使用すると、ビルド実行全体を通じてこれらの値の傾向を確認できます。
依存関係タブ
完成したビルドにアーティファクトやスナップショットの依存関係がある場合は、依存関係タブがビルド結果ページに表示されます。ここでは、このビルドの作成にアーティファクトやソースが使用されたビルド(ダウンロードされたアーティファクト)と、現在のビルドのアーティファクトやソースを使用したビルド(配信されたアーティファクト)を調べることができます。さらに、ビルドの間接的な依存関係を表示できます。つまり、たとえば、ビルド A がビルド C と D に依存するビルド B に依存している場合、これらのビルド C と D はビルド A の間接的な依存関係になります。
依存関係タブには、ビルドの依存関係を表示する 3 つのモードがあります。視覚的なタイムライン、構造化リスト、ビルドチェーンです。現在のタスクに最も役立つモードを選択してください。
![ビルド結果の依存関係タブ Dependencies Tab of Build Results](https://resources.jetbrains.com/help/img/teamcity/2024.03/exp-dependencies-tab.png)
「タイムライン」および「リスト」表示モードでは、特定のビルドを名前で検索できます。
![依存関係でパネルを検索 Find Panel in dependencies](https://resources.jetbrains.com/help/img/teamcity/2024.03/dk-searchDependencies.png)
問題タブ
課題トラッカーとの統合が構成されていて、含まれている変更のコメントまたはビルド自体のコメントに少なくとも 1 つの課題が記載されている場合は、現在のビルドに関連する課題のリストが課題タブに表示されます。
コードカバレッジタブ
ビルドランナーでコードカバレッジを構成している場合は、完全な HTML コードカバレッジレポートを含むコードカバレッジタブが表示されます。
カバレッジ内訳セクションのリンクをクリックすると、ドリルダウンして、名前空間、アセンブリ、メソッド、ソースコードなどのさまざまなスコープの統計を表示できます。
コードインスペクションタブ
構成されている場合、コードインスペクションビルドステップの結果はコードインスペクションタブに表示されます。左側のペインを使用して、インスペクションの結果を移動します。フィルタリングされたインスペクションが右側のペインに表示されます。
警告に関心がない場合は、合計からエラーオプションに切り替えてください。
スコープフィルターを使用して、ビューを特定のディレクトリに限定します。これにより、開発者は関心のある特定のコードを管理しやすくなります。
スコープフィルターのインスペクションツリービューを使用して、特定のインスペクションによる結果を表示します。
TeamCity が問題を含むソースコード行番号を表示するように注意します。IDE のコードに移動するには、それをクリックしてください。
重複
ビルド構成のビルドステップの 1 つとして Duplicates ビルドランナーがある場合、ビルド結果に重複タブが表示されます。
タブは次のもので構成されています。
見つかった重複のリスト。新しい唯一のオプションを使用すると、最新のビルドで表示された重複のみを表示できます。
これらの重複を含むファイルのリスト。左右の矢印ボタンを使用して、選択した複製をタブの下部のそれぞれのペインに表示します。
重複を含むファイルフラグメントのソースコードを含む 2 つのペイン。
左上隅のスコープフィルターは、重複を含む特定のディレクトリを一覧表示します。このフィルタリングにより、開発者は目的のコードを管理しやすくなります。
テストタブ
テストタブでは、失敗したテスト、無視されたテスト、成功したテストを切り替えたり、さまざまなフィルターを使用したりできます。
失敗したテストごとに、スタックトレース、期待値と実際の値の差を表示し、テスト履歴に移動し、失敗を調査するチームメンバーを割り当て、IDE でテストを開き、すぐに修正を開始できます。
詳細なテストまたは調査の履歴を表示するには、コンテキストメニューでテスト履歴を表示するまたは調査履歴を表示するをクリックします。
テスト履歴を表示するリンクをクリックするとテスト詳細ページが開き、以下の情報が表示されます。
テストの成功率、テストの実行時間のデータとグラフなど、テストの詳細。
テストのステータス、期間、このテストが実行されたビルドに関する情報を含む完全なテスト履歴テーブル。
テスト期間グラフ
テスト期間グラフは、このビルド構成のビルドで個々のテストを実行するのにかかる時間を比較できます。
テスト期間の結果は、現在ビルド履歴にあるビルドに対してのみ使用可能です。ビルドがクリーンアップされると、このデータは利用できなくなります。
テスト期間グラフでは、次の操作を実行できます。
表示に失敗しましたオプションをオフにして、テストに失敗したビルドを除外します。
平均オプションを選択して日平均値を計算します。
グラフ上にプロットされた点をクリックすると、対応するビルドの結果を含むページに移動します。
グラフ上のドットのツールチップでビルドサマリーを表示し、対応するビルド結果ページに移動します。
エージェントが特定のエージェントを選択または消去するか、すべてまたはなしリンクをクリックしてすべてのエージェントを選択または消去することによって、情報をフィルタリングします。
Maven ビルド情報タブ
Maven ビルドごとに、ビルドエージェントは Maven 固有のビルドの詳細を収集し、ビルドの完了後に Maven ビルド情報タブに表示されます。このタブは、ビルドエンジニアがビルド構成を調整するときに役立ちます。
クラシック UI タブ
新しい UI ではまだ再現されていない他の従来の UI タブも利用できます。さらにをクリックして、リストから必要なタブを選択します。以下で説明するセクションを表示するために、yu は右上隅のそれぞれのトグルを介して一時的にクラシック UI に切り替えることもできます。
クラシック UI でのビルド履歴
ビルド履歴は、TeamCity によって作成された過去のビルドの記録です。これは、新しい UI ではトレンドウィジェットとして表示され、以下で説明する従来の UI ではリンク付きのメニューとして表示されます。
現在の構成でのビルドの履歴を表示するには、ビルド結果の右上隅にある前のリンクと次のリンクをクリックします。すべての歴史リンクをクリックして、ヒストリータブを開きます。
ナビゲーションメニュー:
ヒストリータブ:
![ビルド履歴 Build history](https://resources.jetbrains.com/help/img/teamcity/2024.03/build-history.png)
クラシック UI で履歴をテストする
従来の UI のテストタブは新しいバージョンとは異なり、CSV ですべてのテストをダウンロードする機能やポップアップ期間のグラフイメージなど、いくつかの独自の機能が含まれています。その機能が必要なときはいつでも一時的に切り替えることができます。
関連ページ:
![](https://resources.jetbrains.com/help/img/teamcity/2024.03/project-home-mode.png)
ビルド結果を扱う
TeamCity には、ホームと設定の 2 つの主要なモードがあります。ホームモードは、プロジェクトおよびビルド構成レベルでビルド結果を蓄積します。新しい TeamCity UI を使用している場合は、プロジェクトサイドバーを介してこの階層間を移動できます。各モードには、独自の詳細レベルがあります。プロジェクト全体のビルド統計を確認するには、プロジェクトホームにアクセスしてください。単一のビルド構成の詳細を参照するには、その名前をクリックしてビルド構成ホームを開きます。ホームページで特定のビルド...
![](https://pleiades.io/icons/teamcity.png)
TeamCity RESTAPI について
TeamCity は、外部アプリケーションを統合し、TeamCity サーバーとのスクリプトの相互作用を作成するための RESTAPI を提供します。URL パスを介してリソース(エンティティ)にアクセスできます。REST API を使用するために、外部アプリケーションは TeamCity サーバーに HTTP リクエストを行い、応答を解析します。このドキュメントは、TeamCity REST API の一般的な説明と、現在の REST API バージョンの状態を反映する自動生成されたセクション...
![](https://resources.jetbrains.com/help/img/teamcity/2024.03/assign-investigation-button.png)
ビルド障害の調査とミュート
何らかの問題または失敗したテストが原因でビルドが失敗した場合、TeamCity を使用すると、ビルドの失敗の調査を一部のユーザーに割り当てたり、ビルドのステータスに影響を与えないように失敗をミュートしたりできます。失敗したビルド構成全体の調査を割り当てるか、単一のビルドの問題と失敗したテストを調査 / ミュートできます。調査 / ミュート機能は、ビルドの問題と失敗したテストに対して同じように機能します。必須アクセス権:特定のプロジェクトで調査 / ミュートを管理および表示できるようにするには、...
![](https://resources.jetbrains.com/help/img/teamcity/2024.03/dk-customRun-general.png)
カスタムビルドの実行
通常、ビルド構成ではビルドトリガーを使用して、必要なスケジュールに従って、または TeamCity がソースコード内の新しい変更を検出したときに新しいビルドを開始します。これらの自動的にトリガーされるビルドに加えて、TeamCity ではビルドを手動で実行し、必要に応じて設定をカスタマイズすることもできます。つまり、新しいプロパティの追加または既存のプロパティの変更、特定の変更の選択、ビルドのスケジュール、ビルドを実行するエージェントの選択などを行うことができます。TeamCity には、カスタ...
![](https://resources.jetbrains.com/help/img/teamcity/2024.03/externalChangesViewer.png)
外部変更ビューアー
TeamCity は、JetBrains Upsource や AtlassianFisheye などの外部変更ビューアーとの統合をサポートしています。一部のビューアーはすぐにサポートされます。GitHub、VSTS、Bitbucket へのコミットが自動的に認識され、変更を外部から表示できるリンクが提供されます。他の外部変更ビューアーを有効にするには、ファイルを作成して構成します。これらの設定は、外部変更ビューアーを使用する VCS ルートごとに指定する必要があります。使用可能なフォーマット、変...
![](https://resources.jetbrains.com/help/img/teamcity/2024.03/dk-buildInternalID.png)
ビルドログ
ビルドログは、ビルドの拡張コンソール出力です。これは、ビルド中に発生したイベントの構造化リストによって表されます。通常、TeamCity で実行されたアクションに関するエントリと、ビルド中に開始されたプロセスの出力が含まれます。TeamCity は、プロセスの出力をキャプチャーし、階層表示を可能にする内部形式で保存します。ビルドログを表示する:完全なログの詳細を表示するには、ビルド結果ページに移動し、ビルドログタブに切り替えます。このタブには、ログを表示するための次のオプションがあります。すべ...