自動マージ

自動マージビルド機能は、構成されたフィルターに一致するブランチ内のビルドを追跡し、ビルドが構成された条件を満たす場合 (たとえば、ビルドが成功した場合)、指定された宛先ブランチにマージします。

VCS サポート

この機能は、Git、Mercurial、Perforce VCS ルートを利用するビルド構成でサポートされています。 VCS ルートには、TeamCity が少なくとも 2 つのブランチを扱えるようにするブランチ仕様が必要です。

自動マージ設定

ビルド機能を追加する方法に関する注意事項については、ビルド機能の追加を確認してください。
この機能で使用されるすべてのブランチは、必要がありますリポジトリに存在し、現在のビルド構成のブランチ仕様に含まれている必要があります。

オプション	説明
ブランチのビルドを見る	ビルドのソースがマージされるブランチを指定します。ブランチフィルターで続きを読む。
ブランチに統合	ソースがマージされる宛先ブランチの論理名。ここでパラメーター参照がサポートされています。ブランチはリポジトリに存在し、ブランチ仕様に含まれている必要があります。
コミットメッセージのマージ	マージコミットのメッセージ。デフォルトは `ブランチ '%teamcity.build.branch%' をマージ` に設定されています。ここでパラメーター参照がサポートされています。
次の場合にマージを実行します	マージがいつ実行されるかを定義する条件（正常なビルドのみ、またはブランチからのビルドが宛先ブランチに新しい問題を追加しない場合）。
マージポリシー	マージコミットを作成するか、早送りマージを実行するかを選択します。 Perforce ディポを対象とする構成の場合、自動マージ機能は常にマージ (`p4 マージ`) を使用し、コピー (`p4 コピー`) は使用しません。ストリーム `任意のマージ`/`下方向のマージ` オプションは無視されます。
実行ポリシー	マージするタイミングを選択します。ビルド終了後にマージ: ビルドが終了すると、マージが開始されます。ビルド期間にはマージ時間は含まれません。マージがまだ進行中であっても、依存ビルドを開始できます。ビルド終了前にマージ: ビルドが完了したと見なされるのは、マージが完了したときだけです。依存ビルドは、マージが完了した後にのみ開始されます。

カスケードマージ

このようなビルド機能をビルド構成に追加することにより、マージ操作のカスケードを定義できます。

たとえば、すべての機能ブランチを 統合 ブランチに自動的にマージし、その後 統合 からデフォルトブランチへの別のマージを構成するとします。これを実現するには、二つの自動マージビルド機能を追加できます: 一方は +:機能-* ブランチをウォッチして 統合 ブランチにマージし、もう一方は +:統合 ブランチをウォッチして デフォルト ブランチにマージします。その後、ビルド構成では 機能-* および 統合 ブランチをビルドできるようにする必要があります。

関連する TeamCity ブログ投稿も参照してください。

2026 年 9 月 11 日