TeamCity On-Premises 2026.2 Help

ビルド承認

ビルド承認 ビルド機能を使用すると、ユーザーは承認を使用してビルドの開始を手動で制御できます。 このビルド機能により、承認ルールで定義された個々のユーザーまたはグループによって承認されない限り、ビルドが開始されないことが保証されます。

この機能は、デプロイ、リソースを消費するビルド、リソースの削除操作など、複数の人の承認が必要なプロセスに役立ちます。 承認により、ユーザーが誤ってビルドをトリガーすることも防止されます。

指定された期間内にビルドが承認されない場合、ビルドはキャンセルされます。

ビルド承認設定

ビルド構成に ビルド承認を追加

このビルド構成のすべてのビルドには、承認が必要です。

オプション

説明

承認規則

  • ユーザーベースのルールでは、特定の ユーザー からの承認が必要です。各ユーザーは ユーザー:<ユーザー名> 構文で指定してください。 改行で区切ったユーザーのリストを使用してください。

  • グループベースのルールでは、特定の グループ のメンバーから一定数の承認が必要です。各ルールは グループ:<グループキー>:<承認数> 構文に従う必要があります。 改行で区切ったグループのリストを使用してください。

例: 以下のルールでは、 チームリーダー ユーザー、 プロジェクト管理者 ユーザー、 品質保証 グループの少なくとも 2 人のメンバーによって承認された場合にのみビルドを開始できます。

user:teamlead user:projectadmin group:QA:2

複数のユーザーやグループからの承認を必要とするルールを複数指定できます。 この場合、ビルドを開始するには すべて のルールを満たす必要があります。

ユーザーが複数のルールに該当する場合(例: ユーザーがルールで参照されている複数のグループに属している場合)、そのユーザーからの承認は各ルールにカウントされます。 上記の例では、 チームリーダー ユーザーが 品質保証 グループのメンバーである場合、ビルドが プロジェクト管理者チームリーダー によって承認されると、ビルドの開始に必要なのは 品質保証 グループからの承認があと 1 つだけです。

括弧を使用すると、個々のユーザーまたはユーザーグループを、共通の投票数を持つ単一の投票権限にグループ化できます。 複数のグループには グループ キーワードを、特定の TeamCity ユーザーには users を使用します:

(groups:QA_TEST,DEVELOPERS,users:john.doe,jane.doe):3

このルールでは、グループ内の任意の組み合わせから合計 3 票が必要です。 例:

  • jane.doejohn.doe 、任意の DEVELOPERS メンバー。

  • 任意の 3 つの QA_TEST メンバー。

  • 2 つの DEVELOPERS メンバーと john.doe;

  • その他。

タイムアウト

承認されない場合、ビルドまでの期間(分単位)は自動的にキャンセルされます。 デフォルトは 360 分(6 時間)です。

手動で開始したビルドを承認として扱います

このオプションが有効になっていて、ビルドを承認する権利を持つユーザーによってビルドがトリガーされた場合、この機能はこのユーザーからの承認をこのビルドに自動的に追加します。 このオプションが有効になっていない場合でも、ビルドをトリガーしたユーザーに関係なく、ビルドにはルールで指定されたユーザーからの明示的な承認が必要です。

通知 & 監査

すべての承認者にメール通知が送信されます。これは、 通知ルールのデフォルト設定に含まれており、 すべてのユーザーグループに適用されます。 関連する Slack 通知の追加を検討してください。 ビルド承認に関連する通知は、通知ルール内の 自分の変更を含むビルドのみ オプションをオーバーライドします。

また、 ビルド構成に通知を追加するには、 通知 ビルド機能を、 ビルドには承認が必要です オプションを有効化した状態で使用することもできます。

ビルドがユーザーによって承認されると、対応する 監査エントリが作成されます。

2026 年 9 月 11 日