GitHub の environment(環境)とは、Actions のジョブに承認・待ち時間・秘密を結び、規則を満たすまで走らせない仕組みです。
- environment に付けられる保護の規則(required reviewers・wait timer・deployment branches・environment secrets)と、それぞれの止まり方
- 承認待ちのジョブを REST API の pending_deployments で見つけ、通すまでの手順
- 当社の AIエージェント(AI の席)が承認待ちに気づかず止まった記録と、そこから決めた見張り方
environment で何が止まるのか
workflow のジョブに environment: 名前 と書くと、そのジョブは environment の保護の規則(deployment protection rules)をすべて満たすまで始まりません。まだ無い名前を書くと、その名前の environment が規則も秘密も無い状態で作られます(GitHub Docs: Managing environments for deployment)。private の repo で environment を設定できるのは GitHub Pro・GitHub Team などのプランで、GitHub Free の利用者は public の repo だけです(同)。
| 保護の規則 | 効き目 | 止まった時に見える姿 |
|---|---|---|
| Required reviewers | 最大 6 人またはチームを承認者に指定。うち 1 人が承認すればジョブが進む | run に「Review deployments」が出て、ジョブは承認まで待つ。却下すると workflow は失敗 |
| Prevent self-review | デプロイを始めた人は、承認者に入っていても自分では承認できない | 自分が dispatch した run を自分で通せない |
| Wait timer | ジョブが起動してから指定の分数だけ待たせる(1〜43,200 分=30 日) | 時間が来るまで待ち、過ぎれば進む |
| Deployment branches and tags | No restriction/Protected branches only/Selected branches and tags のどれかで、出せる branch と tag を絞る | 合わない ref から走らせたジョブは environment に入れない |
| Environment secrets | その environment を参照するジョブだけが読める秘密 | 承認などの規則を通るまで、ジョブは秘密を読めない |
出典: GitHub Docs「Managing environments for deployment」「Deployments and environments」「Reviewing deployments」(2026-11-18 に確認)。数値(6 人・1〜43,200 分)は同資料の記載。
注意したいのは、承認待ちの間は失敗にならないことです。ジョブは「待っている」だけなので、終わりを待つ見張りにとっては、走っている途中と見分けがつきにくくなります。
当社が承認待ちで止まった記録
当社では AI の席が workflow を dispatch し、その結果を見て次の作業へ進みます。この「結果を待つ」所で、environment の承認待ちに何度も足を取られました。
見張りが run の status しか見ていなかった(50 分)
npm へ公開する workflow を dispatch した後、ジョブは environment(npm-publish)の承認待ち(status=waiting)に入っていました。ところが AI の席は「結果待ち」と思い込み、50 分止まりました(社の実測 2026-10-13)。直しは 2 つです。dispatch の直後に REST の pending_deployments を GET し、在れば入力と版を確かめて承認する。見張りは run の status だけでなく、jobs の waiting も見る。npm の公開そのものの組み方は npm publish を GitHub Actions から にまとめています。
「承認待ち 0 件」は撃った道具のせいだった(17 分)
手動で DB の変更を当てる workflow の apply ジョブが、承認待ちで 17 分止まりました。GitHub App の資格で動く gh で pending_deployments を撃つと空が返り、席は「承認待ち 0 件」と読みました。人の口座の gh で撃ち直すと current_user_can_approve=true が出て、承認すると進みました(社の実測 2026-11-04)。ここから決めた規則は、「無い」「0 件」という否定の判定を下す前に、撃った道具がその値を見られるのかを先に疑うことです。gh の資格の切り替えや読み方は GitHub CLI(gh)とは でも触れています。
can が false でも承認は通った(2 回)
pending_deployments が current_user_can_approve=false を返したことが 2 回ありました。承認者は撃った口座自身で、prevent_self_review は false です。それでも POST pending_deployments(state=approved)はそのまま通り、run は in_progress になりました(社の実測 2026-10-22・2026-11-15)。current_user_can_approve の値は「承認できない」の証拠にはなりません。撃ってみて、run の status で結果を測ります。
承認待ちに気づかない間に、出す順番が崩れた
VS Code 拡張を公開する workflow の dry_run が、environment(vscode-publish)の承認待ちで 04:08Z から止まっていました。席は気づかずに待っていました。その間に、ログインに二段目を求める backend を先に本番へ出していたため、二段階認証を登録した利用者が古い拡張のままでは新しくログインできなくなりました。04:25Z に backend を 1 つ前の版へ戻して止めました(社の実測 2026-11-17)。
恒久の直しは出す順番です。新しい応答を読める受け手(拡張)を先に正式版で出し、Marketplace に出たのを見てから backend を出す。拡張の公開は承認を挟むので数十分かかる、と見込んでおきます(社の実測 2026-11-17)。
承認を席が撃って公開まで進めた
うまく回った例もあります。拡張の公開の workflow で environment(vscode-publish)の承認を、席が口座の gh で撃って通し、公開まで進めました。run は success で、版は 1.3.90 と 1.3.116 です(社の実測 2026-10-27・2026-10-30)。
承認待ちを見つけて通す手順
上の記録から、当社は dispatch の後に次の順で確かめています。エンドポイントは GitHub REST API の「Get pending deployments for a workflow run」と「Review pending deployments for a workflow run」です。
| 順 | やること | 撃つ物の例 | 見る所 |
|---|---|---|---|
| 1 | run のジョブを見る | gh api repos/{owner}/{repo}/actions/runs/{run_id}/jobs | run の status だけでなく、ジョブが waiting になっていないか |
| 2 | 承認待ちの environment を取る | gh api repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments | environment.id・reviewers・wait_timer・current_user_can_approve |
| 3 | 空なら、撃った資格を疑う | 人の口座の gh で 2 を撃ち直す | App の資格で空でも、人の口座では出ることがある |
| 4 | 入力と版を確かめて承認する | gh api -X POST …/pending_deployments -F 'environment_ids[]=ID' -f state=approved -f comment='…' | current_user_can_approve=false でも、まず撃ってみる |
| 5 | 結果を run で測る | gh run view {run_id} | in_progress に変わったか。変わらなければ承認されていない |
出典: 手順 1・3・4・5 の見方は社の実測 2026-10-13・2026-11-04・2026-10-22・2026-11-15。エンドポイントと欄の名前は GitHub REST API の docs(2026-11-18 に確認)。
REST の docs では、GET は repo を読める人なら誰でも使え、POST は「repo の contents と deployments を読める required reviewers」が使える、と書かれています。POST の本文には environment_ids・state(approved か rejected)・comment を渡します(GitHub REST API: Review pending deployments for a workflow run)。画面から通す場合は、run を開いて「Review deployments」を押し、environment を選んで「Approve and deploy」を押します(GitHub Docs: Reviewing deployments)。
待つ側の見張りには、「run が終わったか」だけでなく「承認待ちが在るか」を必ず含めます。承認を挟む workflow は、人が見ていない時間帯にそのまま数十分止まるものとして、後に続く作業(たとえば backend の本番反映)の順番を組みます。
environment と OIDC:sub の形が合わない時
environment を参照するジョブが OIDC のトークンを取ると、主語(sub)に environment の名前が入ります。形は repo:ORG-NAME/REPO-NAME:environment:ENVIRONMENT-NAME です(GitHub Docs: OpenID Connect reference)。一方、2026-07-15 より後に作られた repo は、owner と repo の id を含む変わらない形(immutable)の主語が既定になり、それより前の repo は opt in しない限り従来の形のままです(同)。
当社では environment(vscode-publish)に Microsoft Entra のフェデレーション資格情報(発行元 GitHub Actions・種類は環境)を結んだ時、Entra の画面が新しい形の主語 repo:<org>@<org の数字の id>/<repo>@<repo の数字の id>:environment:<環境名> を求めました。GitHub 側のトークンの sub が既定の repo:<org>/<repo>:environment:<環境名> のままだと合いません(社の実測 2026-10-18)。その時は、repo の OIDC の sub の型を合わせるか、Entra に既定の形の資格情報をもう 1 本足します。sub の型は repo や org の OIDC の設定(REST の customization の口)で変えられます(GitHub Docs: OpenID Connect reference)。GCP へ OIDC で入る場合の話は Workload Identity Federation にあります。
よくある質問
required reviewers に入っていれば、自分が始めた run を自分で承認できますか?
environment の「Prevent self-review」が有効だと、デプロイを始めた人は承認者に入っていても承認できません(GitHub Docs: Deployments and environments)。無効なら自分で承認できます。当社では current_user_can_approve=false と返っても、prevent_self_review が false の時は POST の承認が通りました(社の実測 2026-10-22・2026-11-15)。
承認待ちを API で見つけるには?
GET /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments が、規則を満たすのを待っている environment を配列で返します(GitHub REST API docs)。空でも、撃った資格(GitHub App の資格など)がその値を見られない場合があるので、人の口座で撃ち直して確かめます(社の実測 2026-11-04)。
environment secrets と repository secrets は何が違いますか?
environment secrets は、その environment を参照するジョブだけが読め、required reviewers などの規則を通った後に読めるようになります(GitHub Docs: Managing environments for deployment)。本番の鍵を environment 側に置けば、承認を通らないジョブには渡りません。
承認を待てる時間に上限はありますか?
GitHub Docs の environment と Reviewing deployments の頁には、承認待ちの上限の記載がありません(2026-11-18 に確認)。30 日(43,200 分)は wait timer に指定できる最大の分数で、承認待ちの上限ではありません(GitHub Docs: Deployments and environments)。
出典
- GitHub Docs「Managing environments for deployment」 https://docs.github.com/en/actions/deployment/targeting-different-environments/managing-environments-for-deployment(2026-11-18 に確認)
- GitHub Docs「Deployments and environments」 https://docs.github.com/en/actions/reference/workflows-and-actions/deployments-and-environments(2026-11-18 に確認)
- GitHub Docs「Reviewing deployments」 https://docs.github.com/en/actions/managing-workflow-runs-and-deployments/managing-deployments/reviewing-deployments(2026-11-18 に確認)
- GitHub REST API「Get pending deployments for a workflow run」「Review pending deployments for a workflow run」 https://docs.github.com/en/rest/actions/workflow-runs#get-pending-deployments-for-a-workflow-run(2026-11-18 に確認)
- GitHub Docs「About security hardening with OpenID Connect」 https://docs.github.com/en/actions/security-for-github-actions/security-hardening-your-deployments/about-security-hardening-with-openid-connect(2026-11-18 に確認)
- GitHub Docs「OpenID Connect reference」 https://docs.github.com/en/actions/reference/security/oidc(2026-11-18 に確認)
- 当社の実測(2026-10-13・2026-10-18・2026-10-22・2026-10-27・2026-10-30・2026-11-04・2026-11-15・2026-11-17)