VCS 設定値の設定
バージョン管理システム（VCS）は、プロジェクトのソースファイルのリビジョンを追跡するためのシステムです。SCM（ソースコード管理）またはリビジョン管理システムとも呼ばれます。次の VCS は、そのまま TeamCity でサポートされています: Git、Subversion、Mercurial、Perforce、Azure DevOps、CVS、StarTeam。
バージョン管理システムへの接続は、TeamCity VCS ルートによって定義されます。TeamCity のプロジェクトまたはビルド構成には、1 つ以上の VCS ルートを接続できます。また、ビルド構成では、チェックアウト規則などの他のチェックアウトオプションを使用して、ビルドのワークスペースを定義することもできます。
TeamCity は常にサーバー側からリポジトリを監視して変更を検出し、UI に表示します。指定された VCS チェックアウトモードによっては、実際のリポジトリチェックアウトもエージェント側で発生する可能性があります。
TeamCity は各 VCS ルートごとに別々に VCS 関連の操作を実行するため、同じ設定で VCS ルートを再利用することをお勧めします。
VCS ルートでパラメーター参照が使用されている場合、TeamCity は各「VCS ルートインスタンス」ごとに VCS 関連の操作を実行します。ここで、「インスタンス」とは、参照解決後の VCS ルートパラメーターの一意のセットです。VCS ルートにパラメーターを追加しても、実行される VCS 操作の数は減りませんが、設定をより効率的に共有できるようになります。
VCS ルートを接続
VCS ルートの接続または作成
管理に移動し、構成するプロジェクトをクリックします。
プロジェクトの一般設定ページで、ビルド構成にある関連するビルドをクリックします。
サイドバーからバージョン管理設定を選択します。
VCS ルートを接続するをクリックします。
使用可能な既存の VCS ルートが少なくとも 1 つある場合、TeamCity は次のアクションから選択を提供します。
既存の VCS ルートをアタッチします — アタッチする VCS ルートを選択し、チェックアウトルールを更新するフォームに記入します。
新しい VCS ルートを作成する — VCS ルートの設定のガイドラインに従って、新しい VCS ルートを設定します。
チェックアウトルールを設定する
複数の VCS ルートが接続されている場合、またはリポジトリの一部のみをチェックアウトする必要がある場合は、VCS ルートのチェックアウトルールを指定して、ソースのチェックアウトを制御する高度な可能性を提供します。ルールを使用すると、チェックアウト時にビルドエージェントの別の場所にパスを除外したりマップしたりできます。
ビルド構成のチェックアウトオプションを構成する
チェックアウト設定
設定 | 説明 |
|---|---|
VCS チェックアウトモード | プロジェクトソースがエージェントに到達する方法を定義するには、VCS チェックアウトモードオプションを使用します。 |
チェックアウトディレクトリ | ビルドチェックアウトディレクトリは、すべてのビルドのすべてのソースがチェックアウトされる TeamCity エージェントマシン上のディレクトリです。 |
クリーンビルド | ビルド前にチェックアウトディレクトリ内のすべてのファイルを削除するかどうかを定義します。詳細については、クリーンチェックアウトを参照してください。 |
計算設定の変更
設定 | 説明 |
|---|---|
スナップショットの依存関係からの変更を表示する | TeamCity がスナップショット依存関係からの変更を表示するかどうかを構成します。これは、スケジュールトリガーの保留中の変更の処理にも影響します。 |
他のブランチからデフォルトブランチの変更を除外 | デフォルトでは、機能ブランチの保留中の変更またはブランチのビルドの変更を表示する場合、TeamCity にはデフォルトのブランチ (デフォルトのブランチのビルドまで) の変更も含まれます。これにより、ビルドを壊したコミットがデフォルトのブランチでは修正されたが、機能ブランチでは修正されなかったケースを追跡できます。 ただし、複数のチームが同時に多数のブランチを処理している大規模プロジェクトでは、デフォルトブランチでのコミットによってビルドが中断されたとき、またはコミットしたブランチに関係なく、すべてのプロジェクトコミット担当者に通知されます。強制プッシュが行われた場合 機能ブランチのみの変更を表示したい場合は、このボックスをチェックして、デフォルトのブランチの変更を他のブランチに表示しないようにします。 |
ブランチフィルター
ブランチフィルターを使用して、ビルド構成で使用できるブランチのセットを制限できます。デフォルトでは、制限は適用されません。
その他の VCS 関連設定
関連ページ：
Git
TeamCity は、Git をすぐにサポートします。Azure DevOps Services を使用した Git ソース管理がサポートされています (以下の認証に関する注意事項を参照)。このページには、VCS ルート設定の Git 固有のフィールドの説明が含まれています。一般的な VCS ルートプロパティについては、このセクションを参照してください。注意事項: リモート実行とテスト済みのコミットは IntelliJ IDEA プラグインでサポートされています。Visual Studio アドインで...
Subversion
この記事には、VCS ルートを設定するときに使用できる Subversion 固有のフィールドとオプションの説明が含まれています。一般的な VCS ルートプロパティについては、ここで説明します。SVN 接続設定：URL プロジェクトソースを指す SVN URL を指定します。ユーザー名 SVN ユーザー名を指定します。パスワード SVN パスワードを指定してください。構成ディレクトリ代替の Subversion 構成ディレクトリを指定するか、デフォルトのディレクトリを使用することができます（推奨）。...
VCS ルートの設定
VCS ルートは、TeamCity ←→ VCS リポジトリ通信の基礎です。この不可欠な要素は、リポジトリのチェックアウト、コードソースのタグ付け、ビルドステータスの VCS への返信など、さまざまな操作を実行するために必要な VCS プロバイダーへの接続を定義します。VCS ルートには次の情報が保存されます。TeamCity がリモートファイルをプルおよびプッシュするために使用する URL を取得してプッシュします。ブランチ情報: TeamCity が追跡する必要があるリポジトリブランチのリスト...
プロジェクトの作成と編集
TeamCity では、実際のビルドタスクはビルド構成とパイプラインによって実行されます。ただし、どちらもプロジェクト内に配置する必要があります。このトピックでは、プロジェクトを作成するさまざまな方法を説明します。ルートプロジェクトと設定の継承：始める前に、すべての TeamCity サーバーには、ルートプロジェクトと呼ばれる削除不可能な組み込みプロジェクトが含まれていることにご注意ください。すべての新しいプロジェクトはこのプロジェクトの子として作成されますが、ビルド構成やパイプラインを直接ホ...
ビルド構成の作成と編集
ビルド構成とパイプラインは、実際の CI/CD ルーチンを表します。ビルド構成には、一連のビルドステップ（ビルド実行中に実行される基本操作）と、これらのステップの実行に必要な設定が格納されます。これらの設定には以下が含まれます。構成の動作をすばやく変更できるパラメーター。特定の条件が満たされたときに TeamCity が自動的に新しいビルドを開始できるようにするトリガー。構成の機能を拡張する機能を構築します。特定のビルドエージェントで構成ビルドを実行できるようにするエージェント要件。その他。ビル...
VCS チェックアウト規則
VCS チェックアウトルールを使用すると、構成された VCS ルートの一部をチェックアウトし、バージョン管理のディレクトリをビルドエージェントのビルドチェックアウトディレクトリのサブディレクトリにマップすることができます。リポジトリ全体の VCS ルートを定義し、各ビルド構成にその関連部分のみをチェックアウトするように指示することができます。チェックアウトルールは、UI に表示されるビルドの変更と、エージェント上のビルドでチェックアウトされるファイルに影響します。コミットがビルドの VCS ルー...