pull request の作成

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

• [ Pull requests]\(プル要求\) ページで、次の手順を実行します 。

  

• [ファイル] ページで、次 の手順を 実行します。

  

[ プル要求の作成 ] を選択して、 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]

パラメーター

Example

次のコマンドは、 new ブランチから Fabrikam リポジトリの既定の 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 az repos pr update パラメーターで--idを使用します。

たとえば、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. [ 新しいプル要求 ] ページの [ 校閲者] で、[ユーザー とグループの検索] を選択してレビュー担当者として追加します。
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 の間のリンクのみが削除されます。 ブランチまたはコミットから作成されたリンクは、作業項目に残ります。

az repos pr create --work-items <Id1> <Id2>を使用して PR 作成時に Azure Boards の作業項目を PR にリンクできます。ここで、<Idaz repos pr create --work-items <Id1> <Id2> は作業項目の 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 ではサポートされていません。