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

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 を常に最新で高品質に保つ。

| 方式 | やり方 | 向いている場面 |
|---|---|---|
| トランク ベース(機能ブランチ+プル要求) | 短命の機能ブランチを 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 のコード レビューの自動依頼。 下にビルドの検証と状態チェックがある |

| 番号 | 項目 | 説明 |
|---|---|---|
| 1 | Minimum number of reviewers | オンにすると既定値は 2。 今回は 1 にし、作成者の承認は数えない(Allow requestors to approve their own changes はオフ) |
| 2 | Check for linked work items | Required にすると、作業項目がつながっていないプル要求は完了できない |

| 番号 | 項目 | 説明 |
|---|---|---|
| 1 | Check for comment resolution | Required にすると、未解決のコメントがあるプル要求は完了できない |

| 番号 | 項目 | 説明 |
|---|---|---|
| 1 | Allowed 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 に入れる |
| 2 | Reviewers | レビュー担当者。今回は空のまま |
| 3 | Work 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」に変わり、作成者の承認は数えられない |
| 2 | Reviewers | 作成者が任意のレビュー担当者として「Approved」になる |
続けてコメントを 1 つ付けた。

| 番号 | 項目 | 説明 |
|---|---|---|
| 1 | 必須のチェック | 「Comments must be resolved」も加わり、2 つが失敗 |
| 2 | Work items | 「Link work item」の + から作業項目をつなぐ |
③ 条件をそろえてスカッシュで完了する
作業項目 6(検索結果を価格順に並び替えられる)をつなぎ、コメントを「Resolve」にした。

| 番号 | 項目 | 説明 |
|---|---|---|
| 1 | 必須のチェック | 「All required checks succeeded」 |
| 2 | レビュー担当者 | まだ「作成者以外の承認」が足りない |
| 3 | Work items | 作業項目 6 がつながった |
ポリシーの「Allow requestors to approve their own changes」をオンにすると、作成者の承認が数えられた(レビュー担当者が 1 人しかいない検証のため。
実際の運用では別の人に承認してもらう)。

| 番号 | 項目 | 説明 |
|---|---|---|
| 1 | レビュー担当者 | 「1 reviewer approved」 |
| 2 | Complete | 「Set auto-complete」が「Complete」に変わる |

| 番号 | 項目 | 説明 |
|---|---|---|
| 1 | Merge type | スカッシュ コミット |
| 2 | 完了後の処理 | つながった作業項目を完了にする、機能ブランチを削除する(どちらも既定でオン)、マージ コミットのメッセージを変える |

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

| 番号 | 項目 | 説明 |
|---|---|---|
| 1 | マージのコミット | 「Merged PR 1: …」という 1 つのコミットになった |
| 2 | Cherry-pick / Revert | 完了したプル要求から、別のブランチへのコピーや打ち消しができる |
| 3 | Work items | 作業項目 6 は Closed になった(理由は Acceptance tests pass) |
main の履歴は、最初のコミットとスカッシュのコミットの 2 つだけになり、機能ブランチの 2 つのコミットは 1 つにまとまった。
feature/search-sort ブランチは削除されていた。
④ タグを付けて、プル要求を元に戻す
「Repos」⇒「Tags」⇒「New tag」でタグを作る。
Web ポータルで作るタグは注釈付きタグで、説明は必須だった。


| 番号 | 項目 | 説明 |
|---|---|---|
| 1 | v1.1.0 | スカッシュのコミット(3f5ae1ff)に付いた。作成者と日時も残る |
完了したプル要求 1 で「Revert」を押す。

| 番号 | 項目 | 説明 |
|---|---|---|
| 1 | Target branch / Topic branch name | 戻す先(main)と、打ち消しの変更を入れるブランチの名前(自動で入る) |

| 番号 | 項目 | 説明 |
|---|---|---|
| 1 | メッセージ | 「The revert operation successfully created the new branch …」 |
| 2 | 説明 | 「Reverts」のあとに元のプル要求へのリンクが入る |
| 3 | Work items | 元のプル要求の作業項目 6 が自動で入る |
打ち消しもプル要求なので、ブランチ ポリシーの条件(承認、作業項目、コメント)を満たして完了した。

| 番号 | 項目 | 説明 |
|---|---|---|
| 1 | Commits | 最初のコミット、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 のリポジトリの保護




コメント