VCS チェックアウトモード

エージェントのファイルをチェックアウトすることをお勧めします

これは、新しく作成されたビルド構成のデフォルト設定です。 アップグレードする場合、既存のビルド構成のチェックアウトモード設定は保持されます。

この設定を有効化すると、TeamCity は可能な場合、エージェント側のチェックアウト (以下の 「常にエージェントでファイルをチェックアウトする」モードを参照) を使用します。 エージェント側のチェックアウトが不可能な場合、TeamCity は対応する ヘルスレポート項目を表示し、サーバー側のチェックアウト (以下の 「常にサーバーでファイルをチェックアウトする」モードを参照) を使用します。

TeamCity は次の場合にサーバー側のチェックアウトにフォールバックします：

• エージェントに Git または Mercurial クライアントが見つかりません。

• Git または Mercurial クライアントがエージェントに存在しますが、バージョンが間違っています。

• Perforce:

  • エージェントで Perforce クライアントが見つからない場合。

  • ストリームディポが使用され、チェックアウトルールが単純ではない場合 (。 => A 以外)。 この場合にフォールバックを無効にするには、 Perforce ルート設定で 非ストリームワークスペースを作成するオプションを有効にします。 ビルド中にストリームへのコミットが防止されることに注意してください。

常にサーバー上のファイルをチェックアウトする

TeamCity サーバーは各ビルドの前に ソースをエクスポートし、エージェントに渡します。 ソースはチェックアウトではなくエクスポートされるため、エージェントのファイルシステムには管理データは保存されず、バージョン管理操作 (チェックイン、ラベル付け、更新など) はエージェントからは実行できません。 TeamCity は、 ソースをキャッシングし、VCS サーバーから必要な変更のみを取得することで、VCS サーバーとの通信を最適化します。 クリーンチェックアウトが実行されない限り、サーバーは、指定されたチェックアウトディレクトリ内でエージェント上の前回のビルド以降に変更されたファイルのみを更新するための増分パッチをエージェントに送信します。

常にエージェント上のファイルをチェックアウトしてください

ビルドエージェントはビルドの前に ソースをチェックアウトします。 エージェント側のチェックアウトにより、より多くのサーバーリソースが空き、バージョン管理固有のディレクトリ (.svn, CVS, .git) にアクセスできるようになります。つまり、ビルドスクリプトで VCS 操作 (たとえば、バージョン管理へのチェックイン) を実行できます。この場合、ビルドスクリプトがチェックインに必要な資格情報を使用していることを確認してください。

VCS クライアントソフトウェアをエージェントにインストールする必要があります（Perforce、Mercurial、Git に適用可能）。

ファイルを自動的にチェックアウトしないでください

TeamCity はソースを自動的にチェックアウトしませんが、 デフォルトのビルドチェックアウトディレクトリは引き続き作成されるため、ビルドスクリプト経由でソースをチェックアウトするために使用できます。 ビルドに渡された build.vcs.number.* プロパティで指定されたリビジョンでチェックアウトが実行された場合にのみ、TeamCity は変更を正確に報告することに注意してください。

ビルドチェックアウトディレクトリは 含まない 、ディレクトリの有効期限が 設定 されていない限り、自動的にクリーンアップされます。