TeamCity 2019.1ヘルプ

VCSルートの設定

このページで:

TeamCityのVCSルート

VCSルートは、バージョン管理システムへの接続を定義し、TeamCityがバージョン管理(SCM)システムと通信して変更を監視してソースを取得する方法を定義する一連の設定(ソースへのパス、ユーザー名、パスワード、その他の設定)で構成されます。ビルドVCSルートはビルド設定またはテンプレートにアタッチできます。ビルド設定またはテンプレートに複数のVCSルートを追加し、VCSチェックアウト規則を介してパスをチェックアウトしてターゲットにするリポジトリの一部を指定できます。

VCSルートはプロジェクトで作成され、そのプロジェクトまたはそのサブプロジェクトで定義されているすべてのビルド構成で使用できます。

プロジェクト内で設定されたすべてのVCSルートを表示し、プロジェクト設定VCSのルートセクションを使用して作成/編集/削除/デタッチできます。
誰かが複数のプロジェクトまたはビルド構成で使用されるVCSルートを変更しようとすると、TeamCityは、VCSルートへの変更が他のプロジェクトまたはビルド構成に影響を及ぼす可能性があるという警告を発行します。ユーザーは、変更を保存して、影響を受けるすべてのプロジェクトとビルド構成に適用するか、特定のビルド構成またはプロジェクトで使用されるVCSルートのコピーを作成するように求められます。

新しいVCSルートを作成しようとすると、TeamCityは、このプロジェクトで同様の設定でアクセス可能な他のVCSルートがあるかどうかを確認します。そのようなVCSルートが存在する場合、TeamCityは使用することを提案します。

VCSルートが設定されると、TeamCityは定期的にバージョン管理システムに新しい変更を問い合わせ、ルートがアタッチされているビルド構成の変更を表示します。TeamCityがビルド設定のVCSルートの変更を検出するたびに新しいビルドをトリガーするようにビルド設定を設定できます。これはほとんどの場合に適しています。ビルドが開始されると、TeamCityは変更されたファイルをバージョン管理から取得してビルド・チェックアウト・ディレクトリーに適用します。

一般的なVCSルートプロパティー

プロパティー

説明

VCSの種類

TeamCityがサポートするバージョン管理システムのタイプ。たとえば、Perforce、Subversionなど。

VCSルート名

プロジェクトのすべてのVCSルートにわたるVCSルートの一意の名前。

VCSルートID

システム内のすべてのVCSルートにわたるVCSルートの一意のID。VCSルートIDは、VCSルートパラメータおよびREST APIへのパラメータ参照で使用できます。指定しない場合は、VCSのルートパラメータから自動的に生成されます。

リポジトリー URL

VCSリポジトリへのURL。 http(s):// , svn:// , ssh://git@ , git:// などのさまざまな形式の URLと、Maven形式のURLをサポートします。

最小チェック間隔

TeamCityがVCSの変更についてVCSリポジトリをポーリングする頻度を指定します。デフォルトでは、管理 | グローバル設定ページで変更できるグローバル事前定義サーバー設定が使用されます。インターバル時間は、最後のポーリングがVCSルートごとに終了するとすぐに開始されます。ここでは、現在のVCSルートのカスタム間隔を指定できます。

VCSコミットフックが変更のチェックをトリガーするために使用されていることをTeamCityが検出した場合、この間隔は自動的に事前定義された値(4時間)まで増加します。定期的なチェックでコミットフックで検出されない変更が見つかった場合、チェック間隔は指定された最小値にリセットされます。

プロジェクトに属する

各VCSルートはいくつかのプロジェクトに属しており、このセクションにはこのプロジェクトの名前が表示されます。VCSルートは、そのルートが現在使用されているすべてのサブプロジェクト、ビルド構成、およびテンプレートの共通の親プロジェクトに移動できます。

VCS固有の設定の詳細については、次のページを参照してください。