ジョブのビルドおよびレポートの表示

ビルドのログとレポートの表示

ビルドでは、SCMの変更、テスト結果、アクション履歴など、様々なタイプのレポートおよびログが生成されます。これらのレポートは、ジョブ「詳細」またはビルド「詳細」ページから開くには、レポート・アイコンをクリックしてその詳細を表示します。

ビルドによって生成されるレポートのタイプは次のとおりです:

Log/Report	説明
「変更」	ビルドで変更されたすべてのファイルを表示します。ビルドがトリガーされると、ビルド・システムはジョブのGitリポジトリでSCMの変更をチェックします。更新がある場合、SCM変更ログには、追加、編集、または削除されたファイルが表示されます。
アーティファクト	ビルドによって生成された最新のアーカイブ・アーティファクトを表示します。
Javadoc	ビルドJavadoc出力を表示します。このレポートは、アプリケーションのビルドでJavadocが生成された場合にのみ使用できます。
Tests	ビルドのJUnitテスト結果のログを表示します。テスト・スイートの詳細ページを開くには、「テスト結果」ページで「すべてのテスト」切り替えボタンをクリックし、「スイート名」列のスイート名をクリックします。テストの詳細を表示するには、「テスト結果」ページで「失敗したすべてのテスト」切り替えボタンをクリックし、「テスト名」列のテスト名リンクをクリックします。「すべてのテスト」トグル・ボタンをクリックし、テスト・スイートの詳細ページを開いて、「テスト名」列のテスト名のリンクをクリックすることもできます。
「ビルド・ログ」	最新のビルドのログを表示します。ログ・ページで、ビルド・ログを確認します。ログが部分的に表示される場合は、「Full Log」リンクをクリックしてログ全体を表示します。ログをテキスト・ファイルとしてダウンロードするには、「ログのダウンロード」リンクをクリックします。
Gitログ	SCMポーリングによってトリガーされたビルドのログを表示するビルドのGit SCMポーリング・ログを表示します。このログには、スケジュールされたビルドと、SCMアップデートによってトリガーされるビルドが含まれます。ジョブの「ジョブ詳細」ページで、「最新のSCM投票ログ」をクリックして、最後のビルドのGit SCMポーリング・ログを表示します。
監査	ユーザー・アクションの監査ログを表示します。監査ログを使用して、ビルドのユーザー・アクションを追跡できます。ログを使用して、ジョブで特定のアクションを実行したユーザーを確認します。たとえば、ジョブのビルドを取り消したユーザー、またはジョブを無効にしたユーザーと無効になった日時を確認できます。
SonarQube	ジョブのSonarQube分析レポートを表示します。
脆弱性	ジョブMaven、Node.js、JavascriptまたはGradleプロジェクト(あるいはそのすべて)の直接的および推移的な依存関係を識別するセキュリティ脆弱性レポートを表示します。

大きなログ・ファイルの確認

大きいログ・ファイルは、操作が非常に煩雑になる場合があります。多くの場合、ログ・ファイルは大きすぎてブラウザに表示できないため、ダウンロードしてエディタで開く必要があります。ログの主要部分は、ファイルの先頭または末尾にあります。 VB Studioは、無限までスクロールしてファイルの最後まで移動するか、ファイルの最上部に戻るのではなく、このタスクをより簡単にするいくつかの機能を提供します。

ビルドに関する最も興味深い情報は、ログの先頭と末尾にあります。ファイルの一番下に移動した後、スクロールして失敗したフェーズに関する詳細情報を確認し、探している情報がそれらの行にない場合は、ログをダウンロードしてエディタで開く必要があります。

ジョブの詳細ページで、「作成ログ」 toをクリックしてビルド・ログを開きます。
ログ・ファイルが開き、遅延ロード時に行(最大100,000)が表示されます。

「
図log-beginning.pngの説明」
下にスクロールしてログを確認するか、上部にあるフローティング・メニューを使用します。
図log-floating-menu.pngの説明
浮動メニューには、次のオプションがあります:
- 「ログのダウンロード」リンクは常に使用できるため、ログをローカルにダウンロードしてテキスト・エディタで開くことができます。これは、情報を検索する場合に便利です。
- 「トップへ」ボタンをクリックして、ログの先頭に移動します。
- 「一番下に移動」ボタンをクリックして、ログの末尾に移動します。
「一番下に移動」ボタンをクリックして、ビルドのステータスを確認します。

図log-end.pngの説明
ログ・ファイルが100,000行を超える場合は、ログの最後から上にスクロールすると、スキップされた行数を示すメッセージが表示されます。

図log-skipped-lines.pngの説明
「ログのダウンロード」リンクをクリックし、ログ・ファイルをコンピュータにダウンロードして、テキスト・エディタで開き、ログでスキップされた行をスクロールできます。
「トップへ」ボタンをクリックしてログの先頭に戻り、ビルドで使用された設定およびパラメータを確認します。

スクロールすると、ログの遅延がロードされます。いくらでも表示でき、100,000行までスクロールできます。これまでスクロールすると、スキップされた行と最後の100行が表示されます。「下に移動」ボタンをクリックすると、それらのすべての行がロードされ、スキップされた行の通知が表示され、最後の100行が表示されます。

その時点で「トップへ」ボタンをクリックすると、ロードされる内容は変更されません。最初の100,000行と最後の100行が引き続き表示されます。

プロジェクトのビルド履歴の表示

「最近のビルドの履歴」ページには、すべてのプロジェクト・ジョブのビルドが表示されます。

ビルド履歴を表示するには、「ビルド」ページの「ジョブ・キュー」パネルで「最近のビルド履歴の表示」リンクをクリックします。履歴ページには、プロジェクトの最後の50個のビルドが表示されます。ジョブ名をクリックしてその詳細ページを開くか、任意のビルド番号をクリックしてその詳細ページを開きます。ビルド・ログを表示するには、

をクリックします。

ヒント:

表データを列でソートするには、ビルド履歴表の列を右クリックし、「ソート」コンテキスト・メニューからソート順を選択します。

ジョブのビルド履歴の表示

ジョブのビルド履歴は、「ジョブ詳細」ページのビルド履歴セクションで表示できます。実行中のビルドおよび完了したジョブ・ビルドのステータスが、ビルド番号、日時およびビルド・コンソール出力へのリンクとともに降順(最新のものから順に)で表示されます。

ビルド履歴には、ビルドがどのようにトリガーされたかと、そのステータス、ビルド番号および日時スタンプが表示されます。このビューでは、「アクション」メニューをクリックして「ログの表示」を選択し、ビルド・ログを表示するか、「削除」を選択してビルドを削除できます。

ビルド履歴を確認する際には、次の点に注意してください:

「実行者」列には、次のアイコンが表示されます:

アイコン。	意味:
「ユーザー」	ビルドはユーザーによって開始されました。
「SCMの変更」	ビルドはSCMの変更によりトリガーされました。
パイプライン	パイプラインによって作成が開始されました。クリックすると、ビルドのパイプライン・インスタンスが開きます。
「定期構築トリガー」	ビルドは、定期的なビルド・トリガーによってトリガーされました。
「ビルド・システム」	ビルド・システムによってビルドが開始または再スケジュールされました。

破棄および削除されたジョブは、このリストには含まれません。
「ビルド」列のビルド番号の*は、ビルドに説明付きの注釈があることを示します。ビルド番号の上にマウスを移動すると、説明が表示されます。ビルド番号をクリックして、その詳細情報を表示することもできます。
「開始済」列内の行にマウス・ポインタを重ねると、次のようなジョブに関する詳細情報が表示されます:
- ジョブがキューに入れられた時間
- ジョブが開始された正確な時間
- ジョブが完了した時間
実行中のビルドが長時間キュー状態のままである場合は、Queuedステータスの上にマウスを置くと、問題に関するメッセージが表示されます。

ビルドでVMビルド・エグゼクティブを使用する場合は、組織管理者に連絡してステータスを確認できます。
表データを昇順または降順に並べ替えるには、ヘッダー列の名前をクリックし、列ヘッダーの前へまたは次へアイコンをクリックします。

かわりに、表の列内で右クリックし、「ソート」のコンテキスト・メニューからソート順序を選択することもできます。
ビルドを削除できるのはプロジェクト・メンバーのみです。 Non-members cannot.

ユーザー名別ジョブの履歴の表示

監査ログを使用して、ジョブに影響を与えたユーザーとそのタイミングを確認します。たとえば、ジョブのビルドを取り消したユーザーやジョブを無効にしたユーザー、ジョブがいつ無効になったかを確認できます。

監査ログを開くには、ジョブの詳細ページ「監査」

onをクリックします。

ログには、次のような情報が表示されます:

築き上げた人。ユーザー名およびサービス・インスタンス名は、監査ログまたはパイプライン名に表示されます。
ビルド・ジョブが削除された場合、監査ログは作成されませんが、アクティビティ・ストリームにはビルド・ジョブが削除されたことが表示されます。
ビルドはタイマー、Gitリポジトリへのコミットまたはアップストリーム・ジョブによってもトリガーされる場合があります。
ビルドがキューに入れられ、開始および完了した日時
結果が成功したか、再スケジュールされたか、中断されたか、失敗したか
ビルド期間(秒)
ジョブの構成を変更したユーザーのユーザー名およびサービス・インスタンス名、およびタイムスタンプ
ジョブを作成、名前変更、有効化または無効化したユーザーのユーザー名およびサービス・インスタンス名とタイムスタンプ

ビルドの詳細の表示

ビルドの詳細ページには、そのステータスに加えて、ビルドがキューに入れられ、開始され、完了した日時、および合計期間が表示されます。このページには、ビルド・レポートのオープン、アーティファクトのダウンロードおよびログへのリンクも表示されます。ビルドの詳細ページを開くには、ビルド履歴でビルド番号をクリックします。

ビルドの詳細ページから次の一般的なアクションを実行できます:

アクション	方法
ビルドを永久に保存	古いビルドを自動的に破棄するようにジョブが構成されている場合、「forever」とマークされたビルドは削除されません。削除することはできません。ビルドを永久に保持するには、構成をクリックし、「永久にビルドを保持」チェック・ボックスを選択し、「保存」をクリックします。
ビルドに名前と説明を追加	説明と名前の追加は、特定のビルドに永久に保存するようマークし、自動的には破棄されない場合に特に役立ちます。ビルドに説明を追加すると、*が「ビルド履歴」表のビルド番号に追加されます。ビルドを永久に保持するには、構成をクリックします。「名前」および「説明」で詳細を入力し、「保存」をクリックします。
ビルドのログを開く	「ビルド・ログ」をクリックします。
ビルドの削除	「削除」をクリックします。

ビルド・アーティファクトのダウンロード

ビルド・アーティファクトは、ディレクトリ・ツリー構造で表示されます。リンクをクリックして、個々のファイル、ディレクトリおよびサブディレクトリを含むツリーの部分をダウンロードします。

アーティファクトをアーカイブするようにジョブが構成されている場合は、それらをコンピュータにダウンロードし、アーティファクトをwebサーバーにデプロイできます:

ジョブの詳細ページを開きます。
「アーティファクト」をクリックします。

特定のビルド・アーティファクトをダウンロードするには、ビルド履歴でビルド番号をクリックし、「アーティファクト」をクリックします。
ディレクトリ構造を展開し、アーティファクト・リンク(ファイルまたはディレクトリ)をクリックしてダウンロードします。

すべてのアーティファクトのzipファイルをダウンロードするには、(zip内のすべてのファイル) をクリックします。
ファイルをコンピュータに保存します。