ブランチリモート実行トリガー

ブランチリモート実行トリガーは、TeamCity がビルド構成の VCS ルートの特定のブランチで変更を検出するたびに、新しい個人ビルドを自動的に開始します。完了した個人ビルドはビルド履歴にリストされますが、それを開始したユーザーに対してのみリストされます。

現時点では、ブランチリモート実行トリガーは Git および Mercurial VCS のみをサポートします。

ブランチからの非個人ビルドについては、機能ブランチの操作を参照してください。 確認してください。  ブランチ仕様が VCS ルート用に構成されている場合、ブランチリモート実行トリガーは、一致せず、仕様によって除外されていないブランチのみを処理します。

トリガー設定

トリガーは、お名前が特定のパターンに一致するブランチを監視します。
デフォルトのパターンは次のとおりです：

Git リポジトリ用: refs/heads/remote-実行/*
Mercurial リポジトリ用: remote-実行/*

これらのブランチは通常のバージョン管理ブランチであり、TeamCity は管理しません (つまり、ブランチが不要になった場合は、通常のバージョン管理メソッドを使用してブランチを削除する必要があります)。

デフォルトでは、TeamCity はブランチの最後のコミットで検出されたユーザーに対して個人ビルドをトリガーします。ブランチのお名前に TeamCity ユーザーを指定することもできます。そのためには、パターン内でプレースホルダー TEAMCITY_ユーザー名 を使用し、ブランチのお名前に TeamCity ユーザー名を使用します。たとえば、パターン remote-実行/TEAMCITY_ユーザー名/* はブランチ remote-実行/ジョー/my_機能 に一致し、TeamCity ユーザー ジョー の個人ビルドを開始します (そのようなユーザーが存在する場合)。

トリガーできるようにするには、ビルドブランチがメインブランチと比較して少なくとも 1 つの新しいコミットを持っている必要があります。

例: コマンドラインから個人ビルドを実行する

Git

% cd <your_local_git_repo>
% git branch
* master
% git checkout -b my_feature
Switched to a new branch 'my_feature'
//code, commit; code, commit
% git push origin +HEAD:remote-run/my_feature

    

デフォルトのパターン（refs/heads/remote-実行/* ）では、 git ブランチ -r コマンドは個人のブランチをリストします。非表示にする場合は、パターンを refs/remote-実行/* に変更し、変更を refs/remote-実行/my_機能 などのブランチにプッシュします。この場合、ブランチは上記のコマンドではリストされませんが、 git ls-remote <Git リポジトリの URL> を使用して表示できます。

Mercurial

% cd <your_local_hg_repo>
% hg branch
default
% hg branch remote-run/my_feature
marked working directory as branch remote-run/my_feature
//code, commit; code, commit
% hg push -b remote-run/my_feature --new-branch


    

制限事項

ビルド構成にブランチリモート実行をサポートする複数の VCS ルートがあり、そのすべてに変更をプッシュすると、TeamCity は各 VCS ルートにつき、変更を含む単一の個人ビルドを開始します。

トリガーされたビルドのカスタマイズ

トリガーの設定のビルドカスタマイズタブでは、このトリガーによって開始されたビルドのカスタムパラメーターを構成できます。カスタムビルドを実行するダイアログと同様に、ビルドパラメーターの値を上書きし、ビルド前にチェックアウトディレクトリをクリーンアップするかどうかを選択できます。

このタブでは、現在のビルド構成で使用されている任意のパラメーターの値をカスタマイズできます。また、新しいパラメーターを追加することもでき、そのパラメーターはこのトリガーによって開始されるビルドでのみ使用できます。現在のビルドに他のビルドに対するスナップショット依存関係がある場合、このようなパラメーターを使用して、依存ビルド構成の特定のプロパティをオーバーライドすることもできます: このためには reverse.dep.<dependencyBuildID>.<property> 構文を使用します。

トリガー内でビルドパラメーターを再定義してからパラメーターで元のパラメーターを削除すると、その再定義された値がトリガー自体のプレーンテキストパラメーターに変換されることに注意してください。安全な値をカスタマイズするときは、「パスワード」の種類と一緒に保存された場合にのみ隠され、プレーンテキストに変換された場合に読み取り可能になるため、これを考慮することが重要です。

TeamCity では類似したタスクを複数の方法で解決でき、場合によっては別々のビルド構成を作成するほうが依然として望ましいことがあります。たとえば、同じ構成でカスタム実行が多すぎる場合、TeamCity が各ビルドの正確な所要時間を予測しにくくなることがあります。多数の異なるパラメーターでビルドをトリガーする必要がある場合は、ビルド構成テンプレートを作成し、それぞれ独自のパラメーターを持つ複数の構成のブループリントとして使用することをお勧めします。

2026 年 9 月 11 日