Skip to main content

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

GitHubのマージ キューを使用して、プル要求のマージを効率化し、必要なチェックが成功することを確認し、キュー操作を効果的に管理します。

この機能を使用できるユーザーについて

pull request マージ キューは、Organization が所有するパブリック リポジトリ、または GitHub Enterprise Cloud を使っている Organization が所有するプライベート リポジトリで使うことができます。 「GitHubのプラン」を参照してください。

Tool navigation

マージ キューについて

マージ キューは、必要なチェックにパスした後、更新が頻繁な保護されたブランチにプル リクエストをマージするのに役立ちます。 「マージキューの管理」を参照してください。

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

メモ

GitHub CLIを使用して、マージ キューにプル要求を追加できます。 詳細については、この記事の上部にある [GitHub CLI] タブをクリックしてください。

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

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

    リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、[pull request] というラベルが付いたタブが濃いオレンジ色の枠線で囲まれています。

  3. [Pull Requests] の一覧で、マージ キューに追加するプル リクエストをクリックします。

  4. [準備ができたらマージ] をクリックして、pull request をマージ キューに追加します。 または、管理者の場合は、次のことができます。

    • ブランチ保護設定で許可されている場合は、[要件が満たされるのを待たずにマージする (ブランチ保護のバイパス)] をオンにして pull request を直接マージし、標準フローに従います。

    pull request のマージ キューのオプションのスクリーンショット。

    メモ

    すべての要件を満たす前でも、準備ができたらマージをクリックできます。 GitHub は、要件が満たされたときにキューに pull request を追加します。

  5. [準備ができたらマージを確定] をクリックして、pull request をマージキューに追加することを確認します。

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

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

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

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

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

    リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、[pull request] というラベルが付いたタブが濃いオレンジ色の枠線で囲まれています。

  3. [Pull Requests]一覧で、マージキューから削除するプル リクエストをクリックします。

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

    pull request の下部にあるマージ キュー メッセージのスクリーンショット。 [キューから削除] ボタンが濃いオレンジ色の枠線で囲まれています。

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

マージ キューの表示

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

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

  • リポジトリの [ブランチ] ページ。 このルートは、キューに既にプル要求が存在しない場合、または不明な場合、およびそのキュー内の内容を確認する場合にお勧めします。 「リポジトリ内のブランチを表示する」を参照してください。

    リポジトリの [ブランチ] ページのスクリーンショット。 [33 個の pull request がマージのキューに登録済み] というラベルが付いたリンクが濃いオレンジ色の枠線で囲まれています。

  • プル要求ページで、マージ キューがマージに必要な場合は、タイムラインの一番下までスクロールし、 マージ キュー リンクをクリックします。

    pull request の下部にあるマージ キュー メッセージのスクリーンショット。 [マージ キュー] リンクが濃いオレンジの枠線で囲まれています。

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

    リポジトリのマージ キューのスクリーンショット。

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

マージ要求がマージ要件を満たしていない場合、またはキューのチェックが失敗した場合は、マージ キューからプル要求を削除できます。

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

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