pull request の作成

機能ブランチをプッシュまたは更新すると、Azure Repos に PR を作成するためのプロンプトが表示されます。

• [Pull request] ページで:

  

• [ファイル] ページで:

  

[pull request の作成] を選択し、PR の詳細を入力して PR を作成できるページに移動します。

プロジェクトに新しい PR を作成するには、az repos pr create を使用します。 作成後にブラウザーで PR を開くには、--open パラメーターを使用します。

az repos pr create [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--open]
                   [--org]
                   [--project]
                   [--repository]
                   [--reviewers]
                   [--source-branch]
                   [--squash {false, true}]
                   [--subscription]
                   [--target-branch]
                   [--title]
                   [--transition-work-items {false, true}]
                   [--work-items]

パラメーター

例

次のコマンドは、Fabrikam リポジトリの new ブランチから既定の main ブランチへの PR を作成し、ブラウザーで PR を開き、コマンド出力をテーブルに表示します。 この例では、既定の構成 az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber" が使用されています。

az repos pr create --repository Fabrikam --source-branch new --open --output table

ID    Created     Creator              Title                         Status    IsDraft    Repository
----  ----------  -------------------  ----------------------------  --------  ---------  ------------
30    2021-10-31  jamalh@fabrikam.com  Updated note-new-git-tool.md  Active    False      Fabrikam

PR の作成時または作成後に、他の多くの PR 詳細を追加できます。 PR に詳細、レビュー担当者、作業項目、完了オプションを追加するには、詳細の追加または PR の編集に関するページを参照してください。

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。

ドラフト PR を作成するには、PR の作成時に [作成] の横にある矢印を選択し、[ドラフトとして作成] を選択します。 WIP や DO NOT MERGE などのタイトル プレフィックスを使用する必要はありません。

PR をレビューして完成させる準備ができたら、PR の右上にある [発行] を選択します。 PR を発行すると、必要なレビュー担当者が割り当てられ、ポリシーが評価され、投票が開始されます。

既存の発行済み PR をドラフトに変更するには、[ドラフトとしてマーク] を選択します。 PR をドラフトとしてマークすると、既存のすべての投票が削除されます。

ドラフトとして PR を作成するには、PR の作成時に --draft パラメーターを true に設定します (Azure DevOps Server 2020 以降のバージョンが必要です)。

次に例を示します。

az repos pr create --repository Fabrikam --source-branch new --draft true

既存の PR をドラフトに設定するには、az repos pr update --id <PR Id> --draft true を使用します。

PR からドラフトの状態を削除するには、--draft を false に設定します。

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。

az repos pr create を使用して PR の作成時に詳細を追加したり、az repos pr update を使用して既存の PR の詳細を更新したりできます。

az repos pr create を使用して PR を作成する場合は、変更の --title と詳細な --description を追加して、その変更によって解決される問題を他のユーザーが確認できるようにします。 --description パラメーターは Markdown エントリを受け入れ、引数の各値は PR 説明の新しい行です。

次に例を示します。

az repos pr create --repository Fabrikam --source-branch new --title "Update the readme" --description "This PR updates the readme." "These are *new* changes."

レビュー担当者が PR の変更を理解できるように、これらのフィールドを最新の状態に保ちます。 PR の詳細を更新するには、必要な PR --id パラメーターを指定して az repos pr update を使用します。

たとえば、PR #21 のタイトルと説明を更新するには、次を使用します。

az repos pr update --id 21 --description "These updates are *no longer new*." --title "Old updates"

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。

新規または既存の PR の [レビュー担当者] セクションでレビュー担当者を追加できます。 ポリシーで要求されている場合を除き、既存の任意のレビュー担当者を必須にしたり、必須のレビュー担当者を任意に変更または削除したりすることもできます。

ブランチ ポリシーでは、最小数のレビュー担当者を要求したり、PR に特定の任意または必須のレビュー担当者を自動的に含めることができます。 ブランチ ポリシーで必須となっているレビュー担当者を削除することはできません。 ブランチ ポリシーの任意のレビュー担当者は、必要に応じて変更することも、削除することもできます。

レビュー担当者を自動的に追加したブランチ ポリシーを表示するには、PR の [概要] ページの [レビュー担当者] セクションで、レビュー担当者の横にある [その他のオプション] を右クリックします。

PR をレビューするユーザーまたはグループがプロジェクトのメンバーでない場合、それらをレビュー担当者として追加するには、事前にプロジェクトに追加する必要があります。

新しい PR にレビュー担当者を追加するには:

1. [新しい pull request] ページの [レビュー担当者] で、[レビュー担当者として追加するユーザーとグループを検索してください] を選択します。
2. 名前またはメール アドレスを入力すると、一致するユーザーとグループの一覧がドロップダウン リストに表示されます。 一覧から名前を選択して、任意のレビュー担当者として追加します。
3. 必須のレビュー担当者を追加するには、[必須のレビュー担当者の追加] を選択し、[検索して必要なレビュー担当者を追加してください] を選択して名前を検索して選択します。

既存の PR にレビュー担当者を追加するには:

1. [概要] ページの [レビュー担当者] セクションで、[追加] を選択し、[必須のレビュー担当者] または [任意のレビュー担当者] を選択します。

   

2. 名前またはメール アドレスを入力すると、一致するユーザーまたはグループの一覧が表示されます。 レビュー担当者として追加する名前を選択します。

   

レビュー担当者を必須と任意の間で変更する、またはレビュー担当者を削除するには、そのレビュー担当者の名前の右側にある [その他のオプション] を選択します。 レビュー担当者として指定されたグループまたはチームのメンバーシップを表示するには、グループのアイコンを選択します。

次を使用して、作成時に PR に任意のレビュー担当者を追加できます。
az repos pr create --reviewer "<Reviewer Name>" "<Another Reviewer>".

次に例を示します。

az repos pr create --repository Fabrikam --source-branch new --reviewer "[Fabrikam]\Fabrikam Team" "[Fabrikam Fiber]\Web"

必須のレビュー担当者を追加したり、レビュー担当者を任意と必須の間で変更したりするには、ブラウザーで PR を開いて更新します。

既存の PR のレビュー担当者を管理するには、az repos pr reviewer を使用します。

• 既存の PR にレビュー担当者を追加するには、次を使用します。
  az repos pr reviewer add --id <PR Id> --reviewer "<Reviewer Name>" "<Another Reviewer>".
• PR のレビュー担当者を一覧表示するには、az repos pr reviewer list --id <PR Id> を使用します。
• PR からレビュー担当者を削除するには、az repos pr reviewer remove --id <PR Id> --reviewer "<Reviewer Name>" を使用します。

az repos pr reviewer add --id
                         --reviewers
                         [--detect {false, true}]
                         [--org]
                         [--subscription]

パラメーター

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。

作業項目を新しい PR にリンクするには:

1. [新しい pull request] ページの [リンクする作業項目] で、[ID またはタイトルによる作業項目の検索] を選択します。
2. 作業項目 ID またはタイトルの入力を開始し、表示されるドロップダウン リストからリンクする作業項目を選択します。 タイトルで検索すると、状態に応じて絞り込まれた作業項目が返されます。状態カテゴリが [完了] および [削除済み] の状態を持つすべての作業項目は除外されます。 これらの作業項目は日付とユーザーによっても絞り込まれ、過去 30 日間に作成または更新されたアイテムのみが表示され、現在のユーザーによって作成、割り当て、または承認される必要があります。

作業項目を既存の PR にリンクするには:

1. PR の [概要] タブの [作業項目] 領域で、[+] を選択します 。

   

2. 作業項目の ID を入力するか、作業項目のタイトルを検索します。 表示される一覧から作業項目を選択します。

作業項目の横にある [x] アイコンを選択して、作業項目のリンクを削除します。 リンクを削除すると、作業項目と PR の間のリンクのみが削除されます。 ブランチまたはコミットから作成されたリンクは、作業項目に残ります。

PR に作業項目をリンクするには:

1. PR の [概要] タブを選択します。

   

2. [作業項目] 領域の [追加] ボタンを選択します。

3. 作業項目の ID を入力するか、テキストに一致するタイトルを持つ作業項目を検索します。 表示される一覧から作業項目を選択します。 タイトルで検索すると、状態に応じて絞り込まれた作業項目が返されます。状態カテゴリが [完了] および [削除済み] の状態を持つすべての作業項目は除外されます。 これらの作業項目は日付とユーザーによっても絞り込まれ、過去 30 日間に作成または更新されたアイテムのみが表示され、現在のユーザーによって作成、割り当て、または承認される必要があります。

作業項目のリンクを削除するには、作業項目の上にマウス ポインターを合わせると表示される [削除] ボタンを選択します。 リンクを削除すると、作業項目と PR の間のリンクのみが削除されます。 ブランチまたはコミットから作成されたリンクは、作業項目に残ります。

PR の作成時に、az repos pr create --work-items <Id1> <Id2> を使用して Azure Boards 作業項目を PR にリンクできます。ここで、<Id> は作業項目の ID です。

たとえば、次のコマンドは、作業項目 #63 と #64 を new ブランチの新しい PR にリンクします。

az repos pr create --repository Fabrikam --source-branch new --work-items 63 64

既存の PR の作業項目を管理するには、az repos pr work-item を使用します。

• 作業項目を既存の PR にリンクするには、az repos pr work-item add --id <PR Id> --work-items <Id1> <Id2> を使用します。
• PR にリンクされている作業項目を一覧表示するには、az repos pr work-item list --id <PR Id> を使用します。
• PR から作業項目のリンクを解除するには、az repos pr work-item remove --id <PR Id> --work-items <Id1> を使用します。 リンクを解除すると、作業項目と PR の間のリンクのみが削除されます。 ブランチまたはコミットから作成されたリンクは、作業項目に残ります。

az repos pr work-item add --id
                          --work-items
                          [--detect {false, true}]
                          [--org]
                          [--subscription]

パラメーター

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。