pull request を完了、破棄、または元に戻す

PR で有効になっているすべてのブランチ ポリシーを表示するには、必須の id パラメーターを指定した az repos pr policy list を使用します。

az repos pr policy list --id
                        [--detect {false, true}]
                        [--org]
                        [--query-examples]
                        [--skip]
                        [--subscription]
                        [--top]

パラメーター

例

たとえば、PR #28 で有効なポリシーを表示するには、次のコマンドを実行します。

az repos pr policy list --id 28 --output table

Evaluation ID                         Policy                                         Blocking    Status    Expired    Build ID
------------------------------------  ---------------------------------------------  ----------  --------  ---------  ----------
84e7ca6d-0b42-4819-9f62-f41df5e319f3  Minimum number of reviewers (1)                True        Approved
1ba061d8-9e9f-401b-ab61-e2ed1c200aba  Required reviewers (1)                         True
37620a4b-adc4-483d-9ca2-3f4e6ffe2990  Comment requirements                           False       Approved
34b7cae8-812a-4c14-9229-f71a0e662e8b  Required reviewers (1) ([Fabrikam Fiber]\Web)  False
a6e4380e-9f38-4aa5-863c-0fc496027362  Work item linking                              False       Rejected

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

1. 右上にある [完了] を選択して PR を完了します。 または、[完了] ボタンの横にあるドロップダウン矢印を選択し、いずれかのオプションを選択します。

   

   • 完了: 今すぐ PR を完了し、変更をターゲット ブランチにマージします。
   • オートコンプリートの設定: 必要なすべてのブランチ ポリシーを満たしたら、完了してマージするように PR を構成します。
   • ドラフトとしてマーク: PR を下書き状態に戻し、すべての投票を削除します。
   • 破棄: 変更をマージせずに PR を閉じます。

2. [Pull Request の完了] ペインの [マージの種類] で、いずれかのマージ オプションを選択します。

   

   • マージ (早送りなし): すべてのコミットを保持する非線形履歴とマージします。
   • スカッシュ コミット: すべてのソース コミットをターゲット上の 1 つのコミットに結合する線形履歴とマージするか、PR をスカッシュ マージします。 ソース ブランチからのコミット履歴を保持せずに、ターゲット ブランチに対して新しいコミットが作成されることに注意してください。
   • リベースと早送り: ターゲットへのソース コミットをリベースし、早送りします。
   • 半線形マージ: ターゲットへのソース コミットをリベースし、2 つの親のマージを作成します。

   注意

   既存のポリシーが適用されます。 たとえば、ブランチに現在 "スカッシュ マージのみ" ポリシーがある場合、別のマージの種類を使用する場合は、そのポリシーを変更する必要があります。

3. 次のいずれかの完了後オプションを選択します。 オプションによっては、一部のマージの種類では使用できないものがあります。

   • 関連付けられた作業項目をマージ後に完了する: リンクされた作業項目をすべて完了します。
   • マージ後の <branch name> の削除: マージ後に PR のソース ブランチを削除します。
   • マージ コミット メッセージのカスタマイズ: カスタムのマージ コミット メッセージを追加します。 このオプションを選択する場合、マージ コミット メッセージを更新します。
   • ブランチ ポリシーをオーバーライドし、マージを有効にする。 PR がすべてのブランチ ポリシーを満たしているわけではない場合でも、マージを強制します。 このオプションは、ポリシーの適用から除外アクセス許可がある場合にのみ選択できます。

4. [マージの完了] を選択します。

1. 右上にある [完了] を選択して PR を完了します。 または、[完了] ボタンの横にあるドロップダウン矢印を選択し、次のいずれかのオプションを選択します。

   

   • 完了: 今すぐ PR を完了し、変更をターゲット ブランチにマージします。
   • オートコンプリートの設定: ブランチ ポリシーがある場合、必要なすべてのブランチ ポリシーを満たしたら、完了してマージするように PR を構成します。
   • 破棄: 変更をマージせずに PR を閉じます。

2. [Pull Request の完了] 画面で、マージ コミットのメッセージを入力し、PR の説明を更新します。

   

3. 次のいずれかのオプションをクリックします。

   • リンクされた作業項目をマージ後に完了して、リンクされた作業項目をすべて完了します。

   • マージ後に <branch name> を削除して、PR からソース ブランチを削除します。

   • マージする場合にスカッシュが変更して、PR をスカッシュ マージします。 ソース ブランチからのコミット履歴を保持せずに、ターゲット ブランチに対して新しいコミットが作成されることに注意してください。

   • ブランチ ポリシーをオーバーライドし、マージを有効にして、すべてのブランチ ポリシーを満たしているわけではない場合でも、ブランチを強制的にマージします。 このオプションは、ポリシーの適用から除外アクセス許可がある場合にのみ選択できます。

     注意

     既存のポリシーは引き続き適用されます。 たとえば、ブランチに現在 "スカッシュ マージのみ" ポリシーが設定されている場合、他のマージの種類を使用するために、そのポリシーを編集する必要があります。

4. [マージの完了] を選択します。

マージを完了すると、リンクされた作業項目が自動的に更新され、PR 完了が表示されます。

PR を完了して変更をマージするには、az repos pr update を使用して PR の --status を completed に更新します。

たとえば、PR #21 を完了するには、次を使用します。

az repos pr update --id 21 --status completed

完了オプションを設定する

az repos pr create を使用して PR を作成するときに PR 完了オプションを設定するか、az repos pr update を使用して既存の PR の作成オプションを更新することができます。

PR 完了オプションには、次のようなものがあります。

• bypass-policy {false, true}: マージが可能になったら、必要なポリシーをバイパスし、pull request を完了するかどうか。
• bypass-policy-reason: 必要なポリシーをバイパスする理由。
• delete-source-branch {false, true}: pull request が完了しマージされた後にソース ブランチを削除するかどうか。
• merge-commit-message: マージ コミット メッセージをカスタマイズします。
• squash {false, true}: ソース コミットをマージ用の単一のターゲット コミットにスカッシュするかどうか。
• transition-work-items {false, true}: PR がマージされたときにリンクされた作業項目を解決するかどうか。

完了オプションを設定し、既存の PR を完了するには、必要な id パラメーターと一緒に az repos pr update を使用します。

az repos pr update --id
                   [--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]
                   [--org]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--subscription]
                   [--title]
                   [--transition-work-items {false, true}]

パラメーター

例

次の例では、PR #21 を完了し、そのソース ブランチを削除し、リンクされた作業項目を解決して、マージ コミット メッセージを追加します。

az repos pr update --id 21 --status completed --delete-source-branch true --transition-work-items true --merge-commit-message "This update is complete."

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

必要なすべての承認とブランチ ポリシーに合格したときに PR を自動的に完了するように、オートコンプリートを設定します。 PR の作成時にオートコンプリートを設定するか、既存の PR を更新することができます。

• PR の作成時にオートコンプリートを設定するには、az repos pr create --auto-complete true を使用します。
• 既存の PR をオートコンプリートに更新するには、az repos pr update --id <PR Id> --auto-complete true を使用します。

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

変更をマージせずに PR を破棄するには、az repos pr update --id <PR Id> –-status abandoned を使用します。 状態を active に設定することで、PR を再アクティブ化できます。

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