ビルドアーティファクト
アーティファクトのビルドはビルドによって生成されたファイルです。 通常、これらにはディストリビューションパッケージ、WAR ファイル、レポート、ログファイルなどが含まれます。 ビルド構成を作成するときは、 一般設定を構成するページでビルドのアーティファクトへのパスを指定します。
アーティファクトストレージ
TeamCity には、統合された軽量のビルドアーティファクトリポジトリが含まれています。 アーティファクトは、 サーバーアクセス可能ファイルシステムまたは 外部ストレージに保存されます。
ビルドが完了すると、TeamCity はビルド チェックアウトディレクトリ内で、指定された アーティファクトパスまたはパスパターンに従ってアーティファクトを検索します。 一致するファイルはその後 TeamCity サーバーにアップロード (「公開」) され、ウェブ UI からダウンロードできるようになるか、 アーティファクト依存関係を使用して他のビルドで使用できます。 アーティファクトをいつ公開するかは、完了したすべてのビルド、成功したビルドのみ、中断されたビルドも含めたすべてのビルドから選択できます。
ビルドのアーティファクトをダウンロードするには、ビルド結果ページの アーティファクト タブに移動するか、アーティファクトアイコン
を使用します。プロジェクトまたはビルド構成 概要 ページ、およびビルドを一覧表示する TeamCity ページで利用できます。
組み込みストレージの場合、TeamCity は、直接アクセスできるディレクトリ構造でディスク上にアーティファクトを保持します (たとえば、オペレーティングシステムを設定してネットワーク経由でディレクトリを共有する場合)。 ストレージ形式については、 TeamCity データディレクトリで説明しています。 アーティファクトは、追加の圧縮なしで「そのまま」サーバーに保存されます。 デフォルトでは、アーティファクトは <TeamCity データディレクトリ>/system/artifacts ディレクトリ以下に保存されます。このディレクトリは 変更できます。
組み込みのストレージを置き換えるために、 外部アーティファクトストレージを構成できます。
ビルドの実行中にビルドアーティファクトをサーバーにアップロードすることもできます。 TeamCity にアーティファクトをアップロードするよう指示するには、 サービスメッセージを送信するようにビルドスクリプトを変更する必要があります。
REST API を介してアーティファクトのダウンロードを自動化できます。
非表示のアーティファクト
ユーザー定義のアーティファクトに加えて、TeamCity は内部目的でいくつかの 非表示のアーティファクトも生成して公開します。
たとえば、Maven ビルドでは、TeamCity はビルド中に収集された Maven 固有のデータを含む maven-build-info.xml ファイルを作成します。 その後、ファイルの内容はビルド結果の Maven ビルド情報タブで Maven データを可視化するために使用されます。
TeamCity は、アーティファクトのルートにある .teamcity ディレクトリに非表示のアーティファクトを保存します。
アーティファクト依存関係は、パターンで .teamcity を明示的に指定しない限り、非表示のアーティファクトを考慮しません。
.teamcity がクリーンアップスコープで明示的に指定されていない限り、非表示のアーティファクトはアーティファクトのクリーンアップによって削除されません。
隠されたアーティファクトの例:
maven-build-info.xml.gz— Maven ビルドデータ。 Maven ビルド情報 タブにデータを表示するために使用されます。propertiesディレクトリ — エージェントでのビルド用に計算されたプロパティを保持します。 ビルド前とビルド後に実際のプロパティがあります。 これらは、ビルド結果の Properties タブに表示されます。.NETCoverage— 生の .NET カバレッジデータ(たとえば、VS アドインで dotCover データを開くために使用されます)。coverage_idea— 生の IntelliJ IDEA カバレッジデータ(たとえば、IDEA でカバレッジを開くために使用されます)。
非表示のアーティファクトを取得
デフォルトでは、非表示のアーティファクトは アーティファクト タブに表示されません。 現在のビルドにそれらのいずれかがある場合は、 隠しアーティファクトを表示 をクリックして表示できます。
アーティファクトを個別に参照またはダウンロードするには、アーティファクトのツリーを使用します。 .teamcity ディレクトリ全体をダウンロードするには、画面の右側にある すべてダウンロード (.zip) をクリックします。
アーティファクトを非表示
アーティファクトを非表示にするには、 .teamcity ディレクトリでアーティファクトを公開する必要があります。
エージェント上のアーティファクトキャッシュ
ビルドによって公開されたすべてのアーティファクトは、 <ビルドエージェントホーム>\system\.アーティファクト_キャッシング_directory.zip??? のエージェントのアーティファクトキャッシュに保存されます。これにより、場合によってはアーティファクト依存関係が高速化されます。
ただし、アーティファクトのサイズ、 クリーンアップ 、その他の設定によっては、アーティファクトキャッシングによりエージェントのディスク容量が不足することがあります。 公開されたアーティファクトをエージェントキャッシュに保存する方法を 設定できます。