VCS 設定の構成
バージョン管理システム（VCS）は、プロジェクトのソースファイルのリビジョンを追跡するためのシステムです。 SCM（ソースコード管理）またはリビジョン管理システムとも呼ばれます。 次の VCS は TeamCity でそのままサポートされています: Git、 Subversion、 Mercurial、 Perforce、 Azure DevOps、 CVS、 StarTeam。
バージョン管理システムへの接続は、TeamCity の VCS ルートで定義されます。 TeamCity の プロジェクトまたは ビルド構成には、ひとつ以上の VCS ルートを接続できます。また、ビルド構成では、 チェックアウトルールなどの他のチェックアウトオプションを使って、ビルドのワークスペースを定義することもできます。
TeamCity は常にサーバー側からリポジトリを監視して変更を検出し、UI に表示します。 指定された VCS チェックアウトモードによっては、実際のリポジトリのチェックアウトもエージェント側で行われる場合があります。
TeamCity は各 VCS ルートごとに VCS 関連の操作を個別に実行するため、同じ設定の VCS ルートを再利用することをお勧めします。
VCS ルートで パラメーター参照を使用している場合、TeamCity は各「VCS ルートインスタンス」について VCS 関連の操作を実行します。ここで「インスタンス」とは、参照の解決後の VCS ルートパラメーターの一意の設定です。 VCS ルートにパラメーターを追加しても、実行される VCS 操作の数は減りません。設定をより効率的に共有できるようになるだけです。
VCS ルートの接続
VCS ルートを接続または作成する
管理に移動し、構成するプロジェクトをクリックします。
プロジェクトの 一般設定ページで、 ビルド構成にある関連するビルドをクリックします。
サイドバーから バージョン管理設定を選択します。
VCS ルートを接続するをクリックします。
使用可能な既存の VCS ルートがひとつでもある場合、TeamCity では次のアクションから選択できます：
既存の VCS ルートをアタッチします — アタッチする VCS ルートを選択し、 チェックアウトルールを更新するフォームに記入します。
新しい VCS ルートを作成する — VCS ルートの構成のガイドラインに従って、新しい VCS ルートを構成します。
チェックアウトルールを構成する
複数の VCS ルートが接続されている場合、またはリポジトリの一部のみをチェックアウトする必要がある場合は、 VCS ルートのチェックアウトルールを指定して、ソースのチェックアウトを制御する高度な可能性を提供します。 ルールを使用すると、チェックアウト時にビルドエージェントの別の場所にパスを除外したりマップしたりできます。
ビルド構成のチェックアウトオプションを構成する
チェックアウト設定
設定 | 説明 |
|---|---|
VCS チェックアウトモード | プロジェクトソースがエージェントに届く方法を定義するには、 VCS チェックアウトモードオプションを使用します。 |
チェックアウトディレクトリ | ビルドチェックアウトディレクトリは、すべてのビルドのすべてのソースがチェックアウトされる TeamCity エージェントマシン上のディレクトリです。 |
クリーンビルド | ビルド前にチェックアウトディレクトリ内のすべてのファイルを削除するかどうかを定義します。 詳細については、 クリーンチェックアウトを参照してください。 |
変更計算設定
設定 | 説明 |
|---|---|
スナップショットの依存関係からの変更を表示する | TeamCity が スナップショット依存関係からの変更を表示する かどうかを構成します。 これは、スケジュールトリガーの保留中の変更の処理にも影響します。 |
他のブランチからデフォルトブランチの変更を除外 | デフォルトでは、機能ブランチの保留中の変更またはブランチ上のビルドの変更を表示するとき、TeamCity には デフォルトブランチの変更 (デフォルトブランチ内のビルドまで) も含まれます。 これにより、ビルドを壊したコミットがデフォルトのブランチでは修正されたが、機能ブランチでは修正されなかったケースを追跡できます。 ただし、多数の異なるブランチで複数のチームが同時に作業している大規模プロジェクトでは、たとえばデフォルトブランチでのコミットによってビルドが失敗した場合や強制プッシュが実行された場合に、プロジェクトのすべてのコミッター(コミット先のブランチに関係なく)に通知されることになります。 機能ブランチのみの変更を表示したい場合は、このボックスをチェックして、デフォルトのブランチの変更を他のブランチに表示しないようにします。 |
ブランチフィルター
ブランチフィルターを使用して、ビルド構成で使用できるブランチのセットを制限できます。 デフォルトでは、制限は適用されません。