VCS ラベル付け

VCS の自動ラベル付け

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

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

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

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

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

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

VCS の手動ラベル付け

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

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

Subversion ラベル付けルール

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

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

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

ラベルを作成すると、 トランクまたはブランチのリポジトリパス の下にあるソースは タグディレクトリのリポジトリパス/タグ名 ディレクトリに配置されます。ここで、 タグ名 はビルド構成のラベル付けパターンで定義されたラベル名です。

トランクまたはブランチのリポジトリパス に一致するソースがない場合、ラベルは作成されません。

タグディレクトリのリポジトリパス パスは、リポジトリにすでに存在している必要があります。

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

例: URL svn://アドレス/ルート/プロジェクト の VCS ルートがあり、 svn://アドレス/ルート はリポジトリルートであり、リポジトリの構造は次のとおりです。

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

Perforce でのラベル付け

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

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

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

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

ラベル付けルールの例

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

これには、ビルド構成設定で %\プロジェクト名% 構成パラメーターを設定する必要があります。

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

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