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

マージ キューについて

マージ キューを使用すると、pull request のマージをビジー ブランチに自動化し、互換性のない変更によってブランチが中断されないようにすることで、速度を向上できます。

マージ キューは、 [マージする前にブランチを最新の状態にする] ブランチ保護と同じ利点を提供しますが、pull request の作成者が pull request ブランチを更新し、状態チェックが完了するのを待ってからマージを試みる必要はありません。

マージ キューの使用は、多くの異なるユーザーから毎日比較的多数の pull request がマージされるブランチで特に便利です。

pull request が必要なすべてのブランチ保護チェックに合格すると、リポジトリへの書き込みアクセス権を持つユーザーは、その pull request をキューに追加できます。 マージ キューでは、pull request の変更がターゲット ブランチの最新バージョンとキュー内に既に存在する pull request に適用されたときに、それらが必要な状態チェックをすべて通過したことが保証されます。

マージ キューでは、GitHub Actions または独自の CI プロバイダーを使用して、マージ キュー内の pull request に対して必要なチェックを実行できます。 詳しくは、「GitHub Actions ドキュメント」を参照してください。 マージ キューについて詳しくは、「マージキューの管理」を参照してください。

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

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

1. GitHub で、リポジトリのメイン ページに移動します。

2. リポジトリ名の下にある [pull request] をクリックします。

   

3. [pull request] の一覧で、マージ キューから削除する pull request をクリックします。

4. キューから pull request を削除するには、 [キューから削除] をクリックします。

   

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

マージ キューの表示

• リポジトリの [ブランチ] ページ。 キューにまだ pull request がない場合や、キュー内に既にある pull request がわからない場合で、そのキューの内容を確認したい場合は、このルートを使うことをお勧めします。 詳しくは、「リポジトリ内のブランチを表示する」を参照してください。

  

• マージ キューがマージに必要なときは、pull request のページで、タイムラインの一番下までスクロールし、 [マージ キュー] のリンクをクリックします。

  

• マージ キューのビューに現在キュー内にある pull request が表示され、自分の pull request は明確にマークされます。

  

マージ キューから pull request が削除された理由を理解する

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

pull request をマージ キューから削除できる理由は、数多くあります。

• 構成済みの CI サービスがマージ グループのテスト エラーを報告している
• 成功した CI 結果の待機が、構成されたタイムアウト設定に基づいてタイムアウトした
• ユーザーが API またはマージ キュー インターフェイスを使用して削除を要求した
• ブランチ保護エラーを自動的に解決できなかった