pull request とマージキューのマージ

注: pull request のマージキュー機能は現在、パブリックベータ版であり、変更される可能性があります。

マージキューについて

マージキューを使用すると、必要なすべてのブランチ保護チェックに合格することを保証しつつ、pull request がビジー状態のターゲットブランチにマージされる速度を上げることができます。

pull request が必要なすべてのブランチ保護チェックに合格すると、リポジトリへの書き込みアクセス権を持つユーザーは、その pull request をマージキューに追加できます。

マージキューでは、GitHub Actions を使用できます。詳しくは、「GitHub Actionsのドキュメント」を参照してください。マージキューについては、「マージキューの管理」を参照してください。

マージキューへの pull request の追加

注: pull request をマージキューに追加するには GitHub CLI を使います。詳細については、この記事の上部にある [GitHub CLI] タブをクリックしてください。

GitHub.com で、リポジトリのメインページへ移動します。 1. リポジトリ名の下にある [pull request] をクリックします。
[pull request] の一覧で、マージキューに追加する pull request をクリックします。
[準備ができたらマージ] をクリックして、pull request をマージキューに追加します。または、管理者の場合は、次のことができます。
- ブランチ保護設定で許可されている場合は、 [要件が満たされるのを待たずにマージする (ブランチ保護をバイパス)] をオンにして pull request を直接マージし、標準フローに従います。
注: 提案された変更をマージする準備ができたら、いつでも [準備ができたらマージ] をクリックできます。必要な承認と状態チェックの条件が満たされると、GitHub Enterprise Cloud によって自動的に pull request がマージキューに追加されます。
[準備ができたらマージを確認する] をクリックして、マージキューへの pull request の追加を確認します。

GitHub CLI で、gh pr merge コマンドを使用してマージキューに pull request を追加できます。マージキューを必要とするブランチをターゲットにしている場合、必要なチェックに合格した場合に、このコマンドによって pull request がキューに自動的に追加されます。必要なチェックに合格していない場合、このコマンドによって pull request の自動マージが有効になります。詳しくは、GitHub CLI のマニュアルで gh pr merge をご覧ください。

マージキューからの pull request の削除

マージキューから pull request を削除するには、GitHub.com のリポジトリのページに移動する必要があります。 GitHub CLI を使用して、マージキューから pull request を削除することはできません。

GitHub.com で、リポジトリのメインページへ移動します。 1. リポジトリ名の下にある [pull request] をクリックします。
[pull request] の一覧で、マージキューから削除する pull request をクリックします。
キューから pull request を削除するには、 [キューから削除] をクリックします。

または、ベースブランチのマージキューページに移動し、削除する pull request の横にある [...] をクリックして、 [キューから削除] を選択することもできます。ベースブランチのマージキューページに移動する方法については、下のセクションを参照してください。

マージキューの表示

GitHub Enterprise Cloud のさまざまな場所で、ベースブランチのマージキューを表示できます。 GitHub CLI を使用して、マージキューを表示することはできません。

GitHub Enterprise Cloud のさまざまな場所で、ベースブランチのマージキューを表示できます。

リポジトリの [ブランチ] ページ。キューにまだ pull request がない場合や、キュー内に既にある pull request がわからない場合で、そのキューの内容を確認したい場合は、このルートを使うことをお勧めします。詳しくは、「リポジトリ内のブランチを表示する」を参照してください。
マージキューがマージに必要なときは、pull request のページで、タイムラインの一番下までスクロールし、 [マージキュー] のリンクをクリックします。
マージキューのビューに現在キュー内にある pull request が表示され、自分の pull request は明確にマークされます。

マージキューから削除された pull request の処理

pull request をターゲットブランチの最新バージョンとグループ化し、キュー内でその前に変更した後、必要な状態チェックが失敗した場合、またはベースブランチと競合した場合、GitHub Enterprise Cloud によって pull request がキューから削除されます。 pull request タイムラインには、その pull request がキューから削除された理由が表示されます。

pull request とマージ キューのマージ

この記事の内容

マージ キューについて

マージ キューへの pull request の追加

マージ キューからの pull request の削除

マージ キューの表示