アーティファクトのビルド

アーティファクトストレージ

TeamCity には、統合された軽量ビルドアーティファクトリポジトリが含まれています。アーティファクトは、サーバーアクセス可能ファイルシステムまたは外部ストレージに保存されます。

ビルドが終了すると、TeamCity は、指定されたアーティファクトパスまたはパスパターンに従って、ビルドチェックアウトディレクトリ内のアーティファクトを検索します。一致するファイルは、TeamCity サーバーにアップロード (「公開」) され、Web UI からダウンロードできるようになるか、アーティファクトの依存関係を使用して他のビルドで使用できるようになります。アーティファクトをいつ公開するかは、完了したすべてのビルド、成功したビルドのみ、中断されたビルドも含めたすべてのビルドから選択できます。

ビルドのアーティファクトをダウンロードするには、ビルド結果ページのアーティファクトタブに移動するか、プロジェクトまたはビルド構成の概要ページとビルドを一覧表示する TeamCity ページで使用できるアーティファクトアイコン を使用します。

内蔵ストレージの場合、TeamCity は、直接アクセスできるディレクトリ構造でディスク上にアーティファクトを保存します (たとえば、オペレーティングシステムをネットワーク経由でディレクトリを共有するように構成することによって)。ストレージ形式は、TeamCity データディレクトリで説明されています。アーティファクトは、追加の圧縮なしで「そのまま」サーバーに保存されます。デフォルトでは、アーティファクトは <TeamCity Data Directory> /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 ディレクトリ — エージェントでのビルド用に計算されたプロパティを保持します。ビルド前とビルド後に実際のプロパティがあります。これらは、ビルド結果のプロパティタブに表示されます。

• .NETCoverage — 生の .NET カバレッジデータ（たとえば、VS アドインで dotCover データを開くために使用されます）。

• coverage_idea — 生の IntelliJ IDEA カバレッジデータ（たとえば、IDEA でカバレッジを開くために使用されます）。

エージェント上のアーティファクトキャッシュ

ビルドによって公開されたすべてのアーティファクトは、<Build Agent home>\system\.artifacts_cache のエージェントのアーティファクトキャッシュに保存されます。これにより、場合によってはアーティファクトの依存関係が高速化されます。
ただし、アーティファクトのサイズ、clean-up、その他の設定によっては、アーティファクトのキャッシュによってエージェントのディスク領域が不足する可能性があります。公開されたアーティファクトをエージェントキャッシュに保存するように構成できます。

アーティファクトの作成ビデオガイド