TeamCity オンプレミス 2026.1 ヘルプ

自動マージ

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

VCS サポート

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

自動マージ設定

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

オプション

説明

ブランチのビルドを見る

ビルドのソースがマージされるブランチを指定します。詳細はブランチフィルターを参照してください。

ブランチに統合

ソースがマージされる宛先ブランチの論理名。ここではパラメーター参照がサポートされています。ブランチはリポジトリに存在し、ブランチ仕様に含まれている必要があります

コミットメッセージのマージ

マージコミットのメッセージ。デフォルトは Merge branch '%teamcity.build.branch%' に設定されています。ここでパラメーター参照がサポートされています。

次の場合にマージを実行します

マージがいつ実行されるかを定義する条件(正常なビルドのみ、またはブランチからのビルドが宛先ブランチに新しい問題を追加しない場合)。

マージポリシー

マージコミットを作成するか、早送りマージを実行するかを選択します。

Perforce ディポを対象とする構成の場合、自動マージ機能は常にマージ (p4 merge) を使用し、コピー (p4 copy) は使用しません。ストリーム mergeany/mergedown オプションは無視されます。

実行ポリシー

マージするタイミングを選択します。

  • ビルド終了後にマージ : ビルドが終了すると、マージが開始されます。ビルド期間にはマージ時間は含まれません。マージがまだ進行中であっても、依存ビルドを開始できます。

  • ビルド終了前にマージ : ビルドが完了したと見なされるのは、マージが完了したときだけです。依存ビルドは、マージが完了した後にのみ開始されます。

カスケードマージ

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

例: すべての機能ブランチを integration ブランチに自動的にマージしてから、integration からデフォルトブランチへの別のマージを構成します。これを実現するために、2 つの自動マージビルド機能を追加できます。1 つは +:feature-* ブランチを見て integration ブランチにマージし、2 つ目は +:integration ブランチを見て default ブランチにマージします。ビルド構成では、feature-* および integration ブランチのビルドを許可する必要があります。

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

2025 年 4 月 07 日

関連ページ:

ビルド機能を追加する

ビルド機能は、追加の機能を有効にするために任意のビルド構成に追加できる機能です。例: ステータス発行者のコミットビルド機能は、コードファイルを保存する VCS に TeamCity ビルド結果を公開し、調査自動割り当ては最新の変更によってビルドが壊れたユーザーを識別し、これらの問題を解決するタスクを自動的に割り当てます。構成されたビルド機能は、削除することなくいつでも一時的に無効にできます。TeamCity ビルドの特徴:TeamCity には、構成に追加できる次のビルド機能が付属しています。A...

機能ブランチを使用した作業

分散バージョン管理システム (DVCS) の機能ブランチを使用すると、メインの開発とは独立して機能に取り組み、機能のすべての変更をブランチにコミットし、機能が完了したら変更をメインのブランチにマージできます。このアプローチは、ソフトウェア開発チームに多くの利点をもたらしますが、専用のサポートがない継続的インテグレーションサーバーでは、ビルド構成の重複が頻繁に発生したり、可視性が低下したり、最終的にはプロセスに対する制御が失われるなど、多くの問題も発生します。機能ブランチの TeamCity サポ...

ブランチフィルター

VCS ルートにブランチが指定されている場合、TeamCity のさまざまな操作でブランチフィルターオプションが使用できるようになります。ブランチフィルターの使用箇所:現在、ブランチフィルターは、次の TeamCity 設定ページで構成できます。ビルド構成のバージョン管理設定ビルド構成に使用できるブランチのセットを制限します。このブランチフィルターは、他のブランチフィルターの前に適用され、カスタムビルドダイアログに表示されるブランチ、およびトリガーとビルドフィーチャーに表示されるブランチを制限...

AssemblyInfo パッチャー

AssemblyInfo パッチャービルド機能を使用すると、ファイルを手動でパッチしなくても、アセンブリにビルド番号を自動的に設定できます。このビルド機能を追加するときは、バージョン形式を指定するだけで済みます。TeamCity パラメーター参照を使用できます。AssemblyInfo Patcher は自動チェックアウトでのみ使用する必要があります。このビルド機能が構成されると、最初のビルドステップの前に実行されます。TeamCity は、まずビルドチェックアウトディレクトリにあるファイルの置換...

AWS 認証情報

AWS クレデンシャルビルド機能により、エージェントのビルド内から AWS 接続クレデンシャルにアクセスできるようになります。この機能を使用するには、プロジェクトで少なくとも 1 つの AWS 接続を構成する必要があります。この機能は、AWS CLI を使用してファイルを S3 バケットにアップロードするビルドに認証情報を提供する必要がある場合、AWS ECS タスクまたは AWS SDK に基づくカスタムコードを実行する必要がある場合に役立ちます。このような場合は、一時的な認証情報を使用すること...