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 は変更を正確に報告することに注意してください。

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