Azure Repos とは|ブランチ戦略・プル要求・マージの種類・ブランチ ポリシーを実機で検証(DevOps 編 3)

DevOps

はじめに

DevOps 編の 3 回目は Azure Repos と Git。
Git と TFVC の違い、ブランチ戦略、プル要求とマージの種類、ブランチ ポリシーを押さえたうえで、main を保護し、機能ブランチからプル要求でマージし、タグと元に戻す(Revert)まで試す。
※2026年11月時点の情報です。

前回:Azure DevOps の Wiki とは

Azure DevOps の Wiki とは|プロジェクト Wiki とコード Wiki・Markdown・git での編集・ブランチ保護を実機で検証(DevOps 編 2)
Azure DevOps の Wiki を整理。プロジェクト Wiki とコード Wiki の違い、Markdown、git での編集と .order、ブランチ保護を実機で確かめた。

Azure Repos とは

Azure Repos は、コードを管理するためのバージョン管理のツールの集まり。
Git(分散型)と Team Foundation バージョン管理(TFVC、一元化)の 2 つの種類がある。

種類しくみポイント
Git分散型。開発者ごとに、リポジトリの完全なコピーを手元に持つネットワークにつながっていなくてもコミットできる。新しいプロジェクトの既定
TFVC一元化。
手元には各ファイルの 1 つのバージョンだけを持ち、履歴はサーバーにある
同じプロジェクトで Git と一緒に使える。
今後の投資はすべて Git が対象で、TFVC は整合性の維持にとどまる

Git のリポジトリでは、次の機能が使える。

機能どういうもの
ブランチ ポリシーブランチへの変更をプル要求に限り、レビュー担当者、作業項目のリンク、コメントの解決、マージの種類、ビルドの成功などを条件にする
ブランチのセキュリティブランチごとに、ユーザーやグループの権限を設定する。
リポジトリの権限を継承し、必要に応じて上書きする
ブランチのロックブランチを読み取り専用にし、ほかの人がコミットを追加したり履歴を変えたりできないようにする
タグコミットに名前を付ける。
注釈付きタグ(タガー、メッセージ、日付付き)と軽量タグがあり、Web ポータルで作れるのは注釈付き
機能どういうもの
チェリーピック/元に戻す特定のコミットを別のブランチにコピーする。
マージしたプル要求を打ち消す変更を作る
Git LFS頻繁に変わる大きなバイナリ ファイルを Git の外に置く。
依存関係や再利用するパッケージは Azure Artifacts に置く
フォーク元のリポジトリとコードを共有する別のリモート リポジトリ。
変更はプル要求で元に戻す。
権限、ポリシー、パイプラインはフォークに引き継がれない

公式ドキュメント:
Azure Repos とは | Microsoft Learn
プロジェクトに適したバージョン コントロールの選択 | Microsoft Learn
ブランチのロック | Microsoft Learn
Git タグを使用する | Microsoft Learn
Git リポジトリで大きなファイルを操作する | Microsoft Learn
フォーク | Microsoft Learn

ブランチ戦略

Microsoft の公式ガイドは、ブランチ戦略をシンプルに保ち、次の 3 つを柱にするよう勧めている。
新機能とバグ修正はすべて機能ブランチで作業する。
機能ブランチはプル要求で main にマージする。
main を常に最新で高品質に保つ。

Git のブランチ戦略
方式やり方向いている場面
トランク ベース(機能ブランチ+プル要求)短命の機能ブランチを main(トランク)から切り、プル要求で頻繁に main に戻すほとんどのチーム。Microsoft もトランク ベースの戦略を使っている
リリース ブランチリリースやスプリントの区切りで main から release/… を作り、長く使う。
main には戻さない
複数のバージョンを並行してサポートする。サポートを終えたらロックする
修正の移し方修正はまず main に入れ、チェリーピックでリリース ブランチに移すAzure DevOps のチームが採っているやり方。
リリース ブランチで直してから main に移す方法もある

機能ブランチの名前は、feature/機能名、bugfix/説明、users/ユーザー名/説明 のように規則をそろえる。
ブランチ フォルダーを必須にするポリシーで、名前の規則を強制することもできる。

公式ドキュメント:
Git ブランチ戦略を採用する | Microsoft Learn
Microsoft が DevOps を使用して開発する方法 | Microsoft Learn

プル要求とマージの種類

プル要求は、ブランチの変更を別のブランチ(ふつうは main)に入れる前に、レビューと話し合いをする場。
レビュー担当者は承認、待機、却下などで投票し、コメントで話し合う。
条件がそろったら自動で完了する「自動完了」も設定できる。
完了するときは、次の 4 つのマージの種類から選ぶ。

プル要求のマージの種類
マージの種類履歴向いている場面
マージ(早送りなし)すべてのコミットを残し、親が 2 つのマージ コミットを作る。
履歴は一直線にならない
機能ブランチの細かい履歴も残したい
スカッシュ コミットすべての変更を 1 つの新しいコミットにまとめる。履歴は一直線main の履歴を「1 プル要求=1 コミット」で読みやすくしたい
リベースして早送りコミットを main の先に付け直し、マージ コミットを作らないコミットを 1 つずつ一直線に残したい
半線形マージコミットを main の先に付け直してから、マージ コミットを作る付け直した履歴と、マージの区切りの両方を残したい

公式ドキュメント:
pull requests について | Microsoft Learn
マージ戦略とスカッシュ マージ | Microsoft Learn
pull request を完了、破棄、または元に戻す | Microsoft Learn

ブランチ ポリシー

ブランチに必須(Required)のポリシーを 1 つでも付けると、そのブランチは削除できず、変更はプル要求でしか入れられなくなる。

ポリシー内容
最小レビュー担当者数指定した人数の承認が要る。
作成者の承認を数えるか、最後にプッシュした人の承認を禁止するか、待機・却下があっても完了を許すか、新しいプッシュで投票をリセットするか、を選べる
作業項目のリンクプル要求に作業項目がつながっていないと完了できない(Required)か、警告だけ(Optional)か
コメントの解決すべてのコメントが解決されていないと完了できない(Required)か、警告だけ(Optional)か
マージの種類の制限4 つのマージの種類のうち、使えるものを選ぶ
ポリシー内容
ビルドの検証プル要求の変更を事前にマージしてビルドし、成功を条件にする(パイプラインの回で扱う)
状態チェックほかのサービスが成功の状態を送ってくることを条件にする
レビュー担当者の自動追加特定のフォルダーやファイルを変えたプル要求、またはすべてのプル要求に、レビュー担当者を自動で入れる

ブランチ ポリシーの設定には、リポジトリかブランチの「ポリシーの編集」の権限、またはプロジェクト管理者のメンバーシップが要る。
プロジェクトの「Repositories」の設定では、すべてのリポジトリに共通の設定とポリシーもまとめて決められる。

公式ドキュメント:
ブランチ ポリシーの設定と管理 | Microsoft Learn
ブランチとブランチ ポリシーについて | Microsoft Learn
ブランチ アクセス許可の設定 | Microsoft Learn
Git リポジトリの設定とポリシーを設定する | Microsoft Learn

やってみる

今回の構成と実施すること

今回の構成
手順実施すること確かめること
①main にブランチ ポリシーを付けるmain に直接 push できなくなる
②機能ブランチからプル要求を作る作業項目のリンク、コメントの解決、作成者以外の承認がないと完了できない
③条件をそろえてスカッシュで完了するmain に 1 つのコミットで入り、作業項目が完了、ブランチが消える
④タグを付け、プル要求を元に戻す(Revert)戻すためのブランチとプル要求が自動でできる

① main にブランチ ポリシーを付ける

「Repos」⇒「Branches」で main の行のメニューから「Branch policies」を開く。

ブランチ ポリシー
番号項目説明
1注意書き必須のポリシーを 1 つでも有効にすると、ブランチは削除できず、変更はプル要求が必要になる
2ポリシーの一覧最小レビュー担当者数、作業項目のリンク、コメントの解決、マージの種類の制限、Copilot のコード レビューの自動依頼。
下にビルドの検証と状態チェックがある
レビュー担当者と作業項目のリンク
番号項目説明
1Minimum number of reviewersオンにすると既定値は 2。
今回は 1 にし、作成者の承認は数えない(Allow requestors to approve their own changes はオフ)
2Check for linked work itemsRequired にすると、作業項目がつながっていないプル要求は完了できない
コメントの解決
番号項目説明
1Check for comment resolutionRequired にすると、未解決のコメントがあるプル要求は完了できない
マージの種類の制限
番号項目説明
1Allowed merge types最初は 4 つともオン。今回は Squash merge だけを残した

保存のボタンはなく、切り替えるとそのまま保存された。
この状態で手元から main に直接 push すると、拒否された。

 ! [remote rejected] main -> main (TF402455: Pushes to this branch are not permitted; you must use a pull request to update this branch.)

② 機能ブランチからプル要求を作る

手元で feature/search-sort ブランチを作り、docs/api/検索.md を 2 回に分けてコミットして push した。
「Pull requests」⇒「New pull request」で、わざと作業項目をつながずに作る。

プル要求の作成
番号項目説明
1ブランチfeature/search-sort を main に入れる
2Reviewersレビュー担当者。今回は空のまま
3Work items to linkつなぐ作業項目。今回は空のまま
作成直後のプル要求
番号項目説明
1必須のチェック「Work items must be linked」で失敗
2レビュー担当者「At least 1 reviewer must approve」

作成者(自分)で「Approve」を押した。

作成者の承認
番号項目説明
1レビュー担当者の条件「At least 1 reviewer besides author must approve」に変わり、作成者の承認は数えられない
2Reviewers作成者が任意のレビュー担当者として「Approved」になる

続けてコメントを 1 つ付けた。

コメントを付けたあと
番号項目説明
1必須のチェック「Comments must be resolved」も加わり、2 つが失敗
2Work items「Link work item」の + から作業項目をつなぐ

③ 条件をそろえてスカッシュで完了する

作業項目 6(検索結果を価格順に並び替えられる)をつなぎ、コメントを「Resolve」にした。

必須のチェックが通った
番号項目説明
1必須のチェック「All required checks succeeded」
2レビュー担当者まだ「作成者以外の承認」が足りない
3Work items作業項目 6 がつながった

ポリシーの「Allow requestors to approve their own changes」をオンにすると、作成者の承認が数えられた(レビュー担当者が 1 人しかいない検証のため。
実際の運用では別の人に承認してもらう)。

承認がそろった
番号項目説明
1レビュー担当者「1 reviewer approved」
2Complete「Set auto-complete」が「Complete」に変わる
プル要求の完了
番号項目説明
1Merge typeスカッシュ コミット
2完了後の処理つながった作業項目を完了にする、機能ブランチを削除する(どちらも既定でオン)、マージ コミットのメッセージを変える
禁止されたマージの種類

マージの種類の一覧では、スカッシュ以外の 3 つに「Forbidden by policy」と出た。

完了したプル要求
番号項目説明
1マージのコミット「Merged PR 1: …」という 1 つのコミットになった
2Cherry-pick / Revert完了したプル要求から、別のブランチへのコピーや打ち消しができる
3Work items作業項目 6 は Closed になった(理由は Acceptance tests pass)

main の履歴は、最初のコミットとスカッシュのコミットの 2 つだけになり、機能ブランチの 2 つのコミットは 1 つにまとまった。
feature/search-sort ブランチは削除されていた。

④ タグを付けて、プル要求を元に戻す

「Repos」⇒「Tags」⇒「New tag」でタグを作る。
Web ポータルで作るタグは注釈付きタグで、説明は必須だった。

タグの作成
タグの一覧
番号項目説明
1v1.1.0スカッシュのコミット(3f5ae1ff)に付いた。作成者と日時も残る

完了したプル要求 1 で「Revert」を押す。

元に戻す
番号項目説明
1Target branch / Topic branch name戻す先(main)と、打ち消しの変更を入れるブランチの名前(自動で入る)
元に戻すためのプル要求
番号項目説明
1メッセージ「The revert operation successfully created the new branch …」
2説明「Reverts」のあとに元のプル要求へのリンクが入る
3Work items元のプル要求の作業項目 6 が自動で入る

打ち消しもプル要求なので、ブランチ ポリシーの条件(承認、作業項目、コメント)を満たして完了した。

main の履歴
番号項目説明
1Commits最初のコミット、PR 1(タグ v1.1.0)、PR 2(Revert)が一直線に並ぶ

推奨構成

項目推奨
ブランチ戦略短命の機能ブランチ+プル要求で main に入れる。
複数のバージョンを支えるならリリース ブランチを足す
main のポリシー最小レビュー担当者 1〜2 人(作成者の承認は数えない)、作業項目のリンクとコメントの解決を必須にする
マージの種類履歴を読みやすくするならスカッシュに絞る。完了時に機能ブランチを消す
リリース出したコミットにタグを付ける。サポートを終えたリリース ブランチはロックする
項目推奨
大きなファイルソースとテキストは Git、パッケージは Azure Artifacts、頻繁に変わる大きなバイナリは Git LFS
新しいプロジェクトGit を選ぶ(TFVC への今後の投資はない)

注意事項

項目内容
必須ポリシーの影響ブランチを削除できなくなり、すべての変更がプル要求経由になる
作成者の承認「作成者の承認を数える」をオンにすると、自分だけで完了できてしまう
スカッシュスカッシュのコミットは機能ブランチを参照しないので、機能ブランチは消すのがよい
フォーク権限、ポリシー、パイプラインはフォークに引き継がれない

公式ドキュメント:
ブランチ ポリシーの設定と管理 | Microsoft Learn
マージ戦略とスカッシュ マージ | Microsoft Learn
フォーク | Microsoft Learn

まとめ

・Azure Repos は Git(分散)と TFVC(一元化)を提供し、新しいプロジェクトは Git が既定。
・ブランチ戦略は「機能ブランチ+プル要求で main へ」を基本に、必要ならリリース ブランチを足す。
・main に必須のポリシーを付けると直接 push は TF402455 で拒否され、作業項目のリンク、コメントの解決、作成者以外の承認がそろうまでプル要求は完了できなかった。
・スカッシュで完了すると main は 1 コミットで進み、作業項目は Closed、機能ブランチは削除され、Revert も同じプル要求の流れでできた。

次回:GitHub のリポジトリの保護

GitHub のルールセットとは|ブランチとタグの保護・Azure Boards との連携を実機で検証(DevOps 編 4)
GitHub のルールセットを整理。無料プランで使える範囲、ブランチとタグの保護、Azure Boards アプリでの連携を実機で確かめ、個人のメールが残る落とし穴も紹介。

コメント

タイトルとURLをコピーしました