VCS ラベリング

自動 VCS ラベル付け

TeamCity を設定して、ビルドのステータスに応じてビルドのソースに自動的にラベルを付けることができます。ラベル付けは標準の通知イベントではありません。ビルドが終了した後にバックグラウンドで実行され、ビルドステータスには影響しません。ただし、現在のビルド構成の失敗したビルドに関する通知をサブスクライブしたユーザーには、ラベル付けの失敗について通知されます。

ラベル付けは、ビルド機能として、ビルド構成 / テンプレートごとに構成されます。この機能を追加するときは、ラベル付けするルートとラベル付けパターンを指定する必要があります。現在のビルド構成にブランチが構成されている場合は、選択した特定のブランチからのビルドのみにラベルを付けることができます。

テンプレートから継承されたラベル設定を完全に上書きし、異なるラベルを異なる VCS ルートに適用することが可能です。

ラベル付きビルド構成の VCS 設定を変更すると、次の新しいビルドでのみラベル付けに使用されることに注意してください。

「移動」ラベル（異なるビルドに対して同じ名前のラベル、たとえば SNAPSHOT）は現在、CVS でのみサポートされています。

Teamcity VCS ラベリング機能を使用してタグの作成を自動化する例については、この外部投稿(英語)を参照してください。

手動 VCS ラベリング

ソースに手動でラベルを付けるには、ビルド結果ページに移動し、アクションをクリックして、ドロップダウンメニューからこのビルドソースにラベルを付けるを選択します。

手動ラベル付けでは、ビルドに実際の VCS 設定が使用されます。

Subversion ラベル付けルール

Subversion VCS ルートにラベルを付けるには、SVN リポジトリ構造を定義するラベル付けルールを設定する必要があります。

ラベル付けルールは、改改行コードのルールとして次の形式で指定されます。

リポジトリパスは、相対パスと絶対パス（/ で始まる）のどちらでもかまいません。絶対パスは SVN リポジトリルート（リポジトリの最上位ディレクトリ）から解決され、相対パスは TeamCity VCS ルートから解決されます。

ラベルを作成すると、TrunkOrBranchRepositoryPath にあるソースが tagDirectoryRepositoryPath/tagName ディレクトリに配置されます。tagName は、ビルド構成のラベリングパターンで定義されたラベルの名前です。

TrunkOrBranchRepositoryPath に一致するソースがない場合、ラベルは作成されません。

tagDirectoryRepositoryPath パスは、リポジトリにすでに存在している必要があります。

tagDirectoryRepositoryPath ディレクトリに現在のラベル名のサブディレクトリがすでに含まれている場合、ラベル付けプロセスは失敗し、古いタグディレクトリは削除または影響を受けません。

例: URL svn://address/root/project の VCS ルートがあり、svn://address/root はリポジトリルートであり、リポジトリの構造は次のとおりです。

この場合、ラベル付けルールは次のようになります。

Perforce でのラベリング

2021.2 以降、TeamCity は静的ラベルの代わりに自動ラベルを作成(英語)します。自動ラベルは、変更リストのエイリアスとして機能します。ラベルの Revision フィールドに、TeamCity は現在のビルドでチェックアウトされたリビジョンを表示します。View フィールドの場合、現在の VCS ルートのすべてのパスに関連付けられたマッピングを使用します。

Perforce ラベルの場合、TeamCity はインクルードルールのみをサポートし、エクスクルードルールを無視します。

オプションのメッセージ形式設定を使用すると、Perforce ラベルの説明フィールドに書き込まれるメッセージを指定できます。

静的ラベルを使用する場合は、teamcity.perforce.useStaticLabels=true 内部プロパティを設定することで以前の動作を有効にできます。

ラベル付けルールの例

ラベル付けルールとラベル付けパターンの両方で変数置換を使用できます。さまざまな構成で使用される VCS ルートのラベル付けルールの例を参照してください。

これには、ビルド構成設定で %projectName% 構成パラメーターを設定する必要があります。

デフォルトでは、TeamCity は指定されたターゲットパスの末尾にラベル名を追加します。別のディレクトリ構造を作成し、ターゲットパスの中央にラベルを配置する場合は、次の構文を使用できます。

%%system.build.label%% はタグ名に置き換えられます（最初の二重 %% 記号に注意してください - 重要です）。