TeamCity 2019.1ヘルプ

VCS設定値の設定

このページで:

VCS設定の概要

A Version Control System (VCS) is a system for tracking the revisions of the project source files. It is also known as SCM (source code management) or a revision control system. The following VCSs are supported by TeamCity out-of-the-box: Git , Subversion , Mercurial , Perforce , Team Foundation Server , CVS , StarTeam , ClearCase , SourceGear Vault , Visual SourceSafe.

Connection to a version control system is defined by a TeamCity VCSルート . A project or a build configuration in TeamCity can have one or more VCS roots attached; a build configuration can also define the workspace for the builds via other checkout options like チェックアウト規則

TeamCityは常にサーバー側からリポジトリを監視して変更を検出し、UIに表示します。指定されたVCSチェックアウトモードによっては、実際のリポジトリチェックアウトもエージェント側で発生する可能性があります。

TeamCityは各VCSルートごとに別々にVCS関連の操作を実行するため、同じ設定でVCSルートを再利用することをお勧めします。

パラメータ参照がVCSルートで使用される場合、TeamCityは各「VCSルートインスタンス」ごとにVCS関連の操作を実行します。ここで、「インスタンス」は参照解決後の一意のVCSルートパラメータのセットです。VCSルートにパラメータを追加しても、実行されるVCS操作の数は減りません。設定をより効果的に共有できるようになるだけです。

VCSルートを接続

VCS設定は、プロジェクトまたはビルド構成用のバージョン管理設定ページで構成します。既存のVCSルートをプロジェクト/ビルド構成にアタッチすることも、アタッチする新しいVCSルートを作成することもできます。これはVCSパラメータ設定の主要部分です。VCSルートは、プロジェクトソースが配置されているバージョン管理システムの説明です。VCSルートと設定の詳細についてはこちらをご覧ください。

チェックアウトルールを設定する

複数のVCSルートが接続されている場合、またはリポジトリの一部だけをチェックアウトする必要がある場合は、ソースチェックアウトを制御する高度な可能性を提供するためにVCSルートのチェックアウト規則を指定します。ルールを使用して、チェックアウト時にビルド・エージェントのパスを除外したり、別の場所にマッピングしたりできます。

ビルド構成のチェックアウトオプションを構成する

チェックアウト設定

設定

説明

VCSチェックアウトモード

プロジェクトソースがエージェントに到達する方法を定義するには、VCSチェックアウトモードオプションを使用します。

チェックアウトディレクトリー

ビルド・チェックアウト・ディレクトリーは、すべてのビルドのすべてのソースがチェックアウトされるTeamCityエージェントマシン上のディレクトリーです。

クリーンビルド

ビルド前にチェックアウトディレクトリー内のすべてのファイルを消去するかどうかを定義します。詳細はクリーンチェックアウトを参照してください。

計算設定の変更

このセクションは、以前は表示設定と呼ばれていましたが、変更計算設定TeamCity 2017.1以降に名前が変更されました。

設定

説明

スナップショットの依存関係からの変更を表示する

TeamCityがスナップショット依存関係からの変更表示するかどうかを構成します。これは、スケジュールトリガーの保留中の変更の処理にも影響します。

他のブランチからデフォルトブランチの変更を除外

デフォルトでは、機能ブランチでの保留中の変更またはブランチでのビルドの変更を表示するとき、TeamCityはデフォルトブランチでの変更も含みます ( デフォルトブランチでのビルドまで)。これにより、ビルドを破ったコミットがデフォルトのブランチで修正されたが、機能ブランチで修正されなかった場合を追跡することができます。

ただし、複数のチームが同時に多数のブランチを処理している大規模プロジェクトでは、デフォルトブランチでのコミットによってビルドが中断されたとき、またはコミットしたブランチに関係なく、すべてのプロジェクトコミット担当者に通知されます: 強制プッシュが行われた場合

フィーチャーブランチのみの変更を表示したい場合は、このボックスをチェックして、デフォルトのブランチの変更を他のブランチに表示しないようにします。

ブランチフィルター

TeamCity 2019.1以降、ブランチフィルターを使用してビルド構成に使用できるブランチのセットを制限できます。デフォルトでは、制限は適用されません。

その他のVCS関連設定

  • 新しい変更の検出時にビルドを開始したい場合は、VCSトリガーを設定してください。

  • さらに、VCSラベリングビルド機能を使用して、特定のビルドに使用されるソースのバージョン管理システムにラベルを追加することができます。


関連事項:

管理者ガイド : VCSルートの設定 | VCSチェックアウト規則 | VCSチェックアウトモード | VCSラベリング