Azure DevOps の必須のレビュー担当者:Automatically included reviewers
ブランチ ポリシーの「Automatically included reviewers」は、ブランチへのすべてのプルリクエスト、または特定のファイルやフォルダーを変えるプルリクエストに、人やグループをレビュー担当者として自動で付けます。Required にすると、その人たちが承認するまでプルリクエストを完了できません。Optional なら付けるだけで、待つものはありません。誰の承認でも数える「Require a minimum number of reviewers」とは別のポリシーです。
設定
ブランチのポリシーで、Automatically included reviewers の横の + を押し、新しいレビュー担当者のポリシーを埋めます(Microsoft のブランチ ポリシーのページから。英語版は2026年7月15日更新)。
- Reviewers:人とグループ。
- Required の時は、足した人は全員、足したグループはそれぞれ少なくとも1人の承認が要ります。ポリシーにグループが1つだけの時は、そのメンバーの最低人数を代わりに指定できます。
- ファイルとフォルダー:このレビュー担当者を付けるパス。空にすると、ブランチへのすべてのプルリクエストに付きます。
- Allow requestors to approve their own changes:プルリクエストの作成者の承認でも、このポリシーを満たせます。
- Activity feed message:プルリクエストに出す一言。
コマンドラインでは az repos policy required-reviewer create で、--required-reviewer-ids、Required なら --blocking true、--path-filter、--message、ブランチと --branch-match-type exact か prefix を渡します。
パスの絞り込み
- パスは
/かワイルドカードで始めます。それ以外で始まるパスは効かず、無かったものとして扱われます。 *はスラッシュも含めて何文字でも、?は1文字に当たります。*.sqlはすべての .sql、/ConsoleApplication/*はそのフォルダーの下のすべて、*/.gitignoreはすべての .gitignore です。;でパスを区切り、!は前のパスで入れたものを外します。左から順に読みます。/WebApp/*;!/WebApp/Tests/*は /WebApp のうちテスト以外、!/WebApp/Tests/*だけでは何にも当たりません。- 大文字と小文字は区別しません。
よくあるつまずき
- 何人かのうち1人の承認で足りるようにしたい:1人ずつ足すと全員が必須になります。その人たちをグループにまとめてグループを足せば、メンバーの誰か1人の承認でポリシーを満たします。
- 自分の承認が片方のポリシーにだけ数えられる:このポリシーと Require a minimum number of reviewers には、それぞれ別に「Allow requestors to approve their own changes」があります。こちらだけで許していると、自分の承認で必須のレビュー担当者は満たせても、最低人数は満たせません(数えられない承認の詳しい話)。
- チームが必須のレビュー担当者:プルリクエストはあなたの名前ではなくグループに頼む形になるので、自分がレビュー担当者のプルリクエストを探しても出てきません(見つけ方)。
- 下書き:下書きには必須のレビュー担当者が付きません。公開した時に付き、ポリシーが評価されます(Azure DevOps の下書きプルリクエスト)。
- ポリシーを無視できる権限:その権限がある人には、満たしていないポリシーも参考の表示にすぎず、その人の承認でプルリクエストを完了できます。
IntelliJ IDEA での必須のレビュー担当者
Azure DevOps Pull Requests は、Lesstep が作っている JetBrains IDE(2024.1 以降)と Android Studio のプラグインです。Azure DevOps Services と Azure DevOps Server のプルリクエストを IDE のツールウィンドウに並べます。レビュー担当者の一覧では誰が必須かが分かり、ブランチ ポリシーは、まだ承認していない必須のレビュー担当者・ビルド・コメントの解決など、何が残っているかを言葉で出します。1.0.63 からは、開いているプルリクエストにレビュー担当者(人やチーム)を後から追加できます(必須か任意かを選べます)。レビューの受け箱とブランチ ポリシーは無料、投票・コメント・レビュー担当者の追加・完了・プルリクエストの作成は Pro(30日間の無料試用つき)です。画面は日本語です。
Azure DevOps は Microsoft Corporation の商標、IntelliJ IDEA は JetBrains s.r.o. の商標です。このページは Microsoft・JetBrains のいずれとも提携しておらず、承認も受けていません。
ほかに:5つの投票の意味 · 承認が「最低レビュー担当者数」に数えられない理由 · チームに割り当てられたプルリクエスト · Azure DevOps の下書きプルリクエスト · IntelliJ IDEA で使える Azure DevOps のプルリクエストのプラグインの比較 · English