TeamCity On-Premises 2026.2 Help

ビルドアーティファクト

アーティファクトのビルドはビルドによって生成されたファイルです。 通常、これらにはディストリビューションパッケージ、WAR ファイル、レポート、ログファイルなどが含まれます。 ビルド構成を作成するときは、 一般設定を構成するページでビルドのアーティファクトへのパスを指定します。

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

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

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

ビルドのアーティファクトをダウンロードするには、ビルド結果ページの アーティファクト タブに移動するか、アーティファクトアイコン artifactIcon.png を使用します。プロジェクトまたはビルド構成 概要 ページ、およびビルドを一覧表示する 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??? のエージェントのアーティファクトキャッシュに保存されます。これにより、場合によってはアーティファクト依存関係が高速化されます。
ただし、アーティファクトのサイズ、 クリーンアップ 、その他の設定によっては、アーティファクトキャッシングによりエージェントのディスク容量が不足することがあります。 公開されたアーティファクトをエージェントキャッシュに保存する方法を 設定できます。

ビルドアーティファクトの動画ガイド

2026 年 9 月 11 日