TeamCity オンプレミス 2026.1 ヘルプ

アーティファクトストレージの構成

プロジェクト設定 | アーティファクトストレージタブには、このプロジェクトで構成されたアーティファクトストレージと、親から継承されたストレージが表示されます。

デフォルトでは、組み込み TeamCity アーティファクトストレージが表示され、アクティブとしてマークされています。対応するリンクを使用して別のストレージを有効化することができます。

組み込みアーティファクトストレージ

TeamCity は、ビルドによって生成されたアーティファクトを、TeamCity サーバーがアクセスできるファイルシステムに保存します。アーティファクトのデフォルトのディレクトリの場所は <TeamCity Data Directory> /system/artifacts ですが、再定義できます。

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

TeamCity は、TeamCity ビルドアーティファクトの外部ストレージを有効にするプラグ可能な API を提供します。さまざまなストレージのサポートは、TeamCity の外部プラグインとして実装できます。詳細は、外部ストレージ実装ガイドに記載されています(英語)

アーティファクトの外部ストレージが有効になっている場合でも、TeamCity 内部アーティファクト (ビルドログを含む) は TeamCity サーバーに公開され、組み込みアーティファクトのストレージ内の TeamCity データディレクトリに保存されることに注意してください。

同じことがアーティファクトマッピングに関するメタデータにも適用され、TeamCity データディレクトリのアーティファクトディレクトリに公開されます。バックアップから復元する場合は、外部アーティファクトプラグインが正しく動作するように、それらが復元されていることを確認してください。

Amazon S3 のサポート

TeamCity はビルドアーティファクトを Amazon S3 バケットに保存できます。詳細については、この記事を参照してください。

Azure Artifact ストレージ

Azure Artifact ストレージ(英語)は、JetBrains による実験的なプラグインであり、TeamCity の組み込みアーティファクトのストレージを Azure Blob ストレージに置き換えることができます。

Google Cloud Artifact ストレージ

Google Cloud Artifact Storage は、JetBrains によってプラグイン(英語)として実装されています。

アーティファクトを別のストレージに移行する

TeamCity サーバーには、ビルドアーティファクトを 1 つのストレージから別のストレージに転送するコマンドラインツールが付属しています。このツールは、プロジェクト設定 |Artifacts Storage ページからダウンロードできます。

Download artifacts migration tool

現在、このツールは次の移行ルートをサポートしています。

  • ローカルディレクトリから Amazon S3 バケットへ、またはその逆

  • ある Amazon S3 バケットから別のバケット

他のクラウドストレージオプションのサポートにも取り組んでいます。

詳細: アーティファクト移行ツール

2025 年 4 月 07 日

関連ページ:

プロジェクト管理者ガイド

このセクションでは、プロジェクト管理に焦点を当てます。TeamCity プロジェクトとビルド構成の作成、ビルドステップの設定、依存関係チェーンの構成などについて説明します。基本的な TeamCity ワークフロー:次のダイアグラムは、基本的な TeamCity ワークフローを示しています。TeamCity サーバーはリポジトリの変更を検出しました。サーバーはこの変更をデータベースに書き込みます。ビルド構成に添付されたトリガーは、データベース内の関連する変更を検出し、ビルドを開始します。トリガー...

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

アーティファクトのビルドはビルドによって生成されたファイルです。通常、これらにはディストリビューションパッケージ、WAR ファイル、レポート、ログファイルなどが含まれます。ビルド構成を作成するときは、一般設定を構成するページでビルドのアーティファクトへのパスを指定します。アーティファクトストレージ:TeamCity には、統合された軽量ビルドアーティファクトリポジトリが含まれています。アーティファクトは、サーバーアクセス可能ファイルシステムまたは外部ストレージに保存されます。ビルドが終了すると...

TeamCity データディレクトリ

TeamCity データディレクトリは、TeamCity サーバーが構成、ビルド結果、現在の操作ファイルを保存するために使用するファイルシステム上のディレクトリです。このディレクトリは、すべての構成設定の 1 次ストレージであり、TeamCity のインストールに不可欠なデータを保持します。ビルド履歴、ユーザーとそのデータ、その他のデータはデータベースに保存されます。ディレクトリとデータベースに保存されるデータの説明については、バックアップに関する注意事項を参照してください。このドキュメントや他...

TeamCity の設定とメンテナンス

サーバー構成を変更するには、管理 | グローバル設定に移動します。次の設定ブロックを使用できます。TeamCity の設定:データベース実行中の TeamCity サーバーによって使用されるデータベース。データディレクトリディレクトリを参照できる \<TeamCity データディレクトリ \> パス。アーティファクトディレクトリ TeamCity サーバーがビルドアーティファクト、ビルドログ、その他のビルドデータを保存するために使用するルートディレクトリのリスト。デフォルトの場所はです...

Amazon S3 および S3 互換ストレージ

TeamCity には、Amazon S3 Artifact Storage プラグインがバンドルされており、これにより、ビルドアーティファクトを Amazon S3 バケットや MinIO、バックブレイズ B2 などの S3 互換バケットに保存できます。S3 互換ストレージは、AWS 環境と AWS 以外の環境の両方でホストできます。新しい AWS S3 ストレージを作成してセットアップする:「管理 | <あなたのプロジェクト>」ページに移動し、「アーティファクトストレージ」タブに切...

アーティファクト移行ツール

アーティファクト移行ツールは、ビルドアーティファクトをあるストレージから別のストレージに転送できるコマンドラインツールです。現在、このツールは移行ターゲットとして Amazon S3 バケットと Azure ストレージのみを受け入れます。Azure ストレージを設定するには、バンドルされていないプラグイン Azure Artifact ストレージをインストールする必要があることに注意してください。アーティファクト移行ツールをダウンロードする:このツールはプロジェクト設定 | アーティファクトスト...