GitHub・プルリク・必須のデプロイ・2026年10月27日に確認

GitHub：デプロイが成功するまでプルリクをマージできない

ルールセットやブランチの保護ルールは、ブランチをマージする前に、変更が特定の環境へ正しくデプロイされていることを求められます。GitHub は、既定のブランチへマージする前にステージング環境へデプロイする例を挙げています（GitHub の説明「ルールセットで使えるルール」・2026年10月27日に確認）。そのデプロイが成功するまで、このルールがマージを止めます。

Require deployments to succeed before merging    environments: staging, ...
REST rule type     required_deployments
parameters         required_deployment_environments: ["staging"]
deployment status  error | failure | inactive | in_progress | queued | pending | success

ルールが求めること

設定する所：ルールセットか、ブランチの保護ルールです。保護ルールでは Require deployments to succeed before merging を選び、環境を選びます（GitHub の説明「ブランチの保護ルールの管理」）。
REST API では：ルールセットの種類 required_deployments のルールで、required_deployment_environments が、ブランチをマージする前に正しくデプロイされていなければならない環境です（GitHub の説明「ルールの REST API」）。
環境：production・staging・development のような、デプロイ先の総称です。環境の名前は大文字と小文字を区別しません。個人アカウントのリポジトリでは持ち主が、組織のリポジトリでは admin 権限がある人が設定します。GitHub Free では、環境を使えるのは公開リポジトリだけです（GitHub の説明「デプロイの環境の管理」）。
デプロイの状態：デプロイには error・failure・inactive・in_progress・queued・pending・success の状態が付き、GitHub は一番新しい状態をそのデプロイの今の状態として出します（GitHub の説明「デプロイの状態の REST API」）。

デプロイが成功していない理由

レビュアー待ち：環境を使うジョブは、ランナーに送られる前にその環境の保護ルールを通る必要があります。必須のレビュアー（Required reviewers）があるなら、最大6人・チームのうち1人（リポジトリの読み取り権限以上が要る）が承認します。ワークフローの実行で Review deployments を押し、環境を選んで Approve and deploy を押します。Reject を押すとワークフローは失敗します。Prevent self-review があると、自分が始めた実行は承認できません（GitHub の説明「デプロイのレビュー」）。
待ち時間：Wait timer があると、ジョブは始まってから設定の分数（1〜43,200 分＝30日）待ちます（GitHub の説明「デプロイと環境」）。
デプロイできないブランチ：Deployment branches で、その環境へデプロイできるブランチとタグが絞られていることがあります。
独自の保護ルール：GitHub App が作った保護ルールもデプロイを止められます。
デプロイが失敗した：状態が failure か error です。デプロイのページから各デプロイのワークフローの実行のログへ行けます。

直す所

デプロイを見る：リポジトリのデプロイのページに、デプロイの URL、各デプロイのもとのプルリクとブランチ、状態が出て、コミットとワークフローの実行のログへ行けます。リポジトリの外のフォークからのデプロイには、もとのプルリクとブランチへのリンクが出ません（GitHub の説明「デプロイの履歴を見る」）。
承認してもらう：環境の必須のレビュアーの1人に、ワークフローの実行でデプロイのレビューを頼みます。
保護ルールを迂回する：既定では管理者ができます。ジョブが Pending のあいだに、ワークフローの実行の Deployment protection rules の右の Start all waiting jobs を押し、環境を選んでコメントを書きます。環境は、すべてのデプロイで迂回を許さないようにも設定できます。
ルールを変える：ルールセットやブランチの保護ルールを管理する人が、指定する環境を変えるか、ルールを外します。

IntelliJ IDEA で GitHub のプルリクを見るなら

Lesstep の Pull Request Inbox for GitHub は、JetBrains IDE（2024.1 以降）のプラグインです。プルリクのレビュー・チェック・会話を差分の隣に出し、対象のブランチが許す方法でマージします。対象のブランチのルールセットがデプロイの成功を求めているとき、止まっているプルリクのマージの確認欄に、その環境を挙げます（ブランチの保護の同じ設定は API で返らないので挙げません）。デプロイやデプロイのレビューはせず、それは GitHub でします。受信箱・差分・会話は無料、承認・コメント・解決・マージは Pro（月 US$1.50・30日間の無料試用つき）です。画面は日本語です。

GitHub は GitHub, Inc. の商標、IntelliJ IDEA は JetBrains s.r.o. の商標です。このページは GitHub, Inc.・JetBrains のいずれとも提携しておらず、承認も受けていません。