TeamCity 2019.1ヘルプ

VCSチェックアウト規則

VCSチェックアウトルールを使用すると、構成済みのVCSルートの一部をチェックアウトし、ビルドエージェント上のビルドチェックアウトディレクトリー内のバージョン管理からサブディレクトリーにディレクトリーをマッピングできます。リポジトリ全体のVCSルートを定義し、各ビルド構成のチェックアウトをその関連部分のみにすることができます。

チェックアウト規則は、ビルド用にTeamCityに表示された変更、およびエージェント上のビルド用にチェックアウトされたファイルに影響します。変更を表示し、変更のためのビルドをトリガーしないようにするには、VCSトリガールールを使用します。

一般的な推奨事項は、少数のVCSルート(リポジトリのルートを指す)を持ち、チェックアウトルールを介して特定のビルド設定によってチェックアウトされるものを定義することです。

チェックアウト規則を追加する、ビルド構成のバージョン管理設定ページに移動し、リストでVCSルートを見つけ、チェックアウトルールを編集するをクリックして、ルールを入力するためのフォームを開きます。VCSリポジトリブラウザ VCS-browserIcon.png を使用して、チェックアウトするディレクトリーを選択します。

TeamCityでのPerforceサポートは、チェックアウト規則を大文字と小文字を区別して扱うことに注意してください: チェックアウト規則の編集フォームに次のコメントを追加すると、バージョン管理設定ページでPerforceベースのビルド設定の大文字と小文字を区別しないようにすることができます: ##teamcity ignore-case

構文

以下の例では、リポジトリ内のパス(VCSPath)は設定済みのVCSルートに関連しています。エージェントのパス(AgentPath)はビルドチェックアウトディレクトリーに関連しています。

単一のチェックアウト規則の一般的な構文は次のとおりです。

+|-: VCSPath [=> AgentPath]

規則を入力するときは、次の点に注意してください。

  • 複数のルールを入力するには、各ルールを別々の行に入力する必要があります。

  • ファイルが含まれている場合、ルールがリストされている順序に関係なく、各ファイルに最も具体的なルールが適用されます。

  • 演算子を入力しない場合、デフォルトで +:になります。

規則を使用して、以下の操作を実行できます。

構文

説明

+:.=>AgentPath

ルートをビルドエージェントの Path ディレクトリーにチェックアウトします。

-:VCSPath

VCSPath を除外します(パスはファイル名ではなくディレクトリーでなければなりません)。

+:VCSPath=>.

VCSPath をVCSからビルドエージェントのデフォルトの作業ディレクトリーにマップします。

VCSPath=>NewAgentPath

VCSPath をVCSからビルドエージェントの NewAgentPath ディレクトリーにマップします。

+:VCSPath

VCSPath をVCSからビルドエージェント上の同じ名前のディレクトリー(VCSPath)にマップします。

3つのVCSチェックアウト規則の例

-:src/help +:src=>production/sources +:src/samples=>./samples

上記の例では、最初のルールは src/help ディレクトリーとそのコンテンツをチェックアウトから除外します。3番目のルールは2番目のルールよりも具体的であり、src/samples パスをビルドエージェントのデフォルト作業ディレクトリーの samples パスにマップします。2番目のルールは、src パスの内容をビルドエージェントの production/sources にマップします。ただし、最初のルールによって除外された src/help と、3番目のルールによって異なる場所にマップされた src/samples を除きます。


関連事項:

管理者ガイド : VCSチェックアウトモード