TeamCity の設定とメンテナンス

データベース

実行中の TeamCity サーバーによって使用されるデータベース。

データディレクトリ

ディレクトリを参照できる \< TeamCity データディレクトリ \> パス。

アーティファクトディレクトリ

TeamCity サーバーがビルドアーティファクト、ビルドログ、その他のビルドデータを保存するために使用するルートディレクトリのリスト。デフォルトの場所は system/artifacts です。アーティファクトは外部ストレージに保存することもできることに注意してください。

リストは、改行で区切られたパスのリストを指定することで変更できます。絶対パスと相対パス（TeamCity データディレクトリに対して）がサポートされています。指定されたすべてのディレクトリは同じ構造を使用します。

ビルドアーティファクトを探すときは、指定された場所でビルドに対応するディレクトリを検索します。検索はルートディレクトリが指定された順に行われます。最初に見つかったビルドアーティファクトディレクトリは、このビルドのアーティファクトのソースとして使用されます。

新しく開始したビルドのアーティファクトは、リストの最初のディレクトリに置かれます。

キャッシュディレクトリ

（VCS リポジトリの内容、検索インデックス、その他の）TeamCity 内部キャッシュを含むディレクトリ。このディレクトリからファイルを手動で削除して、キャッシュをクリアできます。

サーバー URL

実行中の TeamCity サーバーの構成可能な URL。

ビルドアーティファクトファイルの最大サイズ

最大サイズ（バイト単位）。KB、MB、GB、TB の接尾辞が許可されます。
\-1 は制限がないことを示します。

ビルドごとのアーティファクトの最大数

ビルドごとに公開されるアーティファクトの数を制限します。
これにより、複数のビルドが多数のアーティファクトを並行して公開する場合に、メモリ消費の問題を防ぐことができます。

デフォルトのビルド実行タイムアウト

ビルドの最大時間。ビルド失敗条件を定義するときに上書きできます。

デフォルトの VCS 変更チェック間隔

デフォルトでは 60 秒に設定されています。TeamCity が VCS リポジトリをポーリングして VCS の変更を確認する頻度を指定します。VCS ルートを構成するときに上書きできます。

さらに、サーバー上のすべての VCS ルートの最小ポーリング間隔として、VCS 変更チェックの間隔を強制できます。これにより、プロジェクト管理者はデフォルトよりも大きい間隔のみを設定できます。これにより、ポーリング要求の頻度が制限され、サーバーの負荷が軽減されます。

デフォルトの VCS トリガーの待機期間

デフォルトでは 60 秒に設定されています。最後の VCS 変更が検出されてからビルドがキューに追加されるまでの期間 (秒単位) を TeamCity が維持する期間を指定します。VCS トリガーを構成するときに上書きできます。

分離保護を有効にする

有効にすると、ビルドアーティファクトは別のドメインから読み込まれ、潜在的な悪意のあるコンテンツは、このコンテンツを表示しているユーザーに代わって TeamCity サーバーと通信できなくなります。これにより、アーティファクトやその他の関連する脆弱性を介した XSS 攻撃のリスクが軽減されます。

このモードでは、TeamCity 専用のドメインを構成する必要があることに注意してください。一部のビルド結果 (カスタムレポートなど) を表示するためにアーティファクトを引き続き使用するには、以下のこのドメインの URL を指定する必要があります。

アーティファクトの URL

ビルドアーティファクトを提供する URL を指定します。アーティファクト分離用の URL と TeamCity サーバーには異なるホスト名が必要であることに注意してください。両方のリソースに同じホスト名の異なるポートを使用すると、ビルドの失敗や TeamCity へのサインインの問題など、さまざまな問題が発生する可能性があります。

何らかのアーティファクトのコンテンツに対するリクエストを受信すると、TeamCity は、このアーティファクトの URL をベースとして使用する一時的な URL にブラウザーをリダイレクトします。一時的な URL は、アーティファクトへの不正アクセスを防ぐために、一定時間が経過すると期限切れになります。期限切れの URL にアクセスすると、通常の認証が実行され、新しい URL が生成されます。
カスタムレポートタブのコンテンツもビルドアーティファクトから取得されるため、同じロジックがカスタムレポートタブにも適用されます。

ローカルホスト経由でのみアクセス可能な個人の TeamCity インストールの場合、http://127.0.0.1[:port]/ のような URL で十分です。

組織で使用される TeamCity サーバーの場合、新しい DNS 名、 CNAME (英語) を、サーバーがインストールされているマシンに登録するか、プロキシ経由で TeamCity にアクセスできる場合はリバースプロキシサーバーに登録する必要があります。この新しいホスト名の URL は、アーティファクトの URL で指定する必要があります。プロキシ側で追加の構成は必要ありません。

注: これはアーティファクトのみを提供するために存在する特別な URL であるため、ユーザーはそれを介して TeamCity インターフェースにサインインすることはできません。