TeamCity On-Premises 2026.2 Help

VCS ルートの構成

VCS ルート は、TeamCity ←→ VCS リポジトリ通信の基盤です。 この不可欠な要素は、リポジトリのチェックアウト、コードソースのタグ付け、ビルドステータスの VCS への返信など、さまざまな操作を実行するために必要な VCS プロバイダーへの接続を定義します。

VCS ルートには次の情報が保存されます。

  • TeamCity がリモートファイルをプルおよびプッシュするために使用するフェッチ URL とプッシュ URL。

  • ブランチ情報: TeamCity がトラックする必要があるリポジトリブランチのリストと、デフォルト (メイン) のブランチ。

  • 認証設定: TeamCity がリポジトリにアクセスするために使用する資格情報。

  • チェックアウト設定: リモートファイルの保存方法と、サブモジュールをメインリポジトリと一緒にチェックアウトするかどうかを指定します。

  • カスタムでは、デフォルトの 60 秒間隔を上書きできるポーリング設定を変更します。

VCS ルートに関連するセクションは、プロジェクト設定と構成設定の両方で使用できます。

プロジェクトと構成のルート設定

ただし、構成はルートを所有することはありません。 構成に VCS ルートを「アタッチ」することはできますが、ルートは常にプロジェクトに保存されます (プロジェクトによって所有されます)。 この手法により、次のようになります。

  • VCS ルートは複数の構成に接続できるため、複数のビルド構成が同じ認証およびチェックアウト設定で同じリポジトリにアクセスできます。

  • 1 つの構成に複数の VCS ルートを接続できるため、1 つの構成内で異なるリポジトリを操作できます。

  • VCS ルートを編集すると、それを使用するすべての構成に影響します。 VCS ルート設定を変更する場合、このルートを複製し、更新された設定をこの新しいクローン内に保存して、元のルートを変更しないというオプションがあります。 これにより、1 つのビルド構成をカスタマイズしながら、このルートを共有する他の構成には影響を与えずに済みます。

VCS ルートは、リモートリポジトリを使用するすべてのビルド構成に不可欠な部分ですが、多くのシナリオでは TeamCity がルートを自動的に生成するため、新しいビルド構成ごとに手動で作成する必要はありません。 例については、 このチュートリアルを参照してください。

共通 VCS ルートプロパティ

VCS のタイプ

TeamCity でサポートされているバージョン管理システムのタイプ。 例: Git、Perforce、Subversion など。

VCS ルートのお名前

プロジェクト内のすべての VCS ルートの中で一意の VCS ルート名。 これは TeamCity UI（たとえば、ビルド構成の「VCS ルートをアタッチ」メニュー）に表示される公開お名前です。

VCS ルート ID

システム内のすべての VCS ルート全体で一意な VCS ルートの ID。 デフォルトでは、ルート ID は親プロジェクトとルート自体のお名前を短縮し、アンダースコアで区切って組み合わせたものです。 例: MyProject_HttpsGitHubComJohndoeMyrepoRefsHeadsMain。 ルートのお名前を変更する場合は、 ID を再生成 リンクをクリックしてこの値を更新できます。

ルート ID は、ルートプロパティを読み取るためのビルドパラメーターで使用されます（例: vcsroot.ProjectName_RootName.branch、 vcsroot.ProjectName_RootName.url）。 また、ID は REST API でも使用できます。

リポジトリ URL

VCS リポジトリの URL。 http(s)://、 svn://、 ssh://git@、 git:// などの 様々な形式の URL に加え、Maven 形式の URL もサポートします。

プロジェクト（またはその親プロジェクト）に VCS プロバイダーへの接続 がある場合、TeamCity はこのフィールドの横に対応する VCS アイコンを表示します。 同じプロバイダー（例: GitHub OAuth と GitHub App）への接続が複数ある場合は、アイコンにマウスポインターを合わせると接続名が表示されます。

VCS ルート設定の接続アイコン

アイコンをクリックすると、TeamCity がこの接続を使用して検出したリポジトリのリストを表示できます。 接続には必要なリポジトリアクセスデータがすべて保存されるため、リポジトリを選択すると リポジトリ URL だけでなく、認証設定（ユーザー名 と パスワード / アクセストークン ）も入力されます。

最小ポーリング間隔

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

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

プロジェクトに属する

この VCS ルートを所有するプロジェクトを表示します。 VCS ルートを親プロジェクトに移動すると、新しい所有者とそのサブプロジェクト内のすべてのビルド構成で使用できるようになります。

VCS 固有の設定の詳細については、このセクション内のページを参照してください。

2026 年 9 月 11 日
VCS 設定の構成リポジトリ URL から設定を推測