GitHub Actionsが動かない時のチェックリスト

Actionsが動かない時は、workflowの場所、yaml、trigger、branch、permissions、Secrets、ログ、Pages build、schedule、直前差分を順番に確認します。

このページでわかること

  • workflowが実行されない原因を分けて見る
  • trigger、branch、permissions、Secretsを確認する
  • CIを止める前にログと差分を見る

まず確認すること

  • workflowファイルの場所と構文を確認する
  • Actions設定と実行ログを見る
  • third-party actionや直前変更を確認する

やってはいけないこと

  • CIを消して終わりにする
  • 失敗ログを無視する
  • 権限を広げて解決扱いにする

安全寄りに進める手順

  1. 対象のrepo、branch、PR、Actions runを確認する。
  2. Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
  3. 必要な場合は値を停止または再発行し、影響範囲を整理する。
  4. 変更は小さなbranchとPRに分け、CIとreviewで確認する。

CodexやAI作業時の注意

AIに作業を渡す時は、対象ファイル、触らないファイル、確認項目を明記します。認証情報や実際のキー値は本文、Issue、PR説明、ログ、レポートに残さないようにします。

公式情報で確認する領域

Actions、Secrets、PR、repository visibility、workflow permissionsは仕様が変わることがあります。実作業前にはGitHub Docsで最新の説明を確認してください。

workflowが起動しない時に、公式が挙げている条件

  • GITHUB_TOKEN が起こしたイベントでは、新しいworkflowの実行は作られません。例外は workflow_dispatch と repository_dispatch です。
  • branches と paths の両方を書いた時は、両方の条件を満たした時だけ動きます。tags だけ、または branches だけを書いた場合、書いていない種類のgit参照への変更では動きません。
  • pathの絞り込みを使っていて、変更されたファイルがなければ動きません。差分が3,000ファイルを超え、該当ファイルが最初の3,000件に入らない場合も動きません。タグのpushではpathの絞り込みは評価されません。
  • workflow_dispatch(手動実行)は、workflowファイルがデフォルトbranchにある時だけイベントを受け取ります。
  • pull_request は、既定では opened、synchronize、reopened の時だけ動きます。PRに merge conflict があると動かないので、先に衝突を直す必要があります。
  • フォークしたリポジトリでは、既定でworkflowは動きません。フォーク側のActionsタブで有効にします。フォークから起動された場合、GITHUB_TOKEN 以外のSecretsはrunnerに渡されません。
  • schedule は、デフォルトbranchの最新commitで動き、最短間隔は5分です。高負荷の時は遅れたり、待ちのjobが落とされたりします。公開リポジトリでは、60日間リポジトリの活動がないと自動で無効になります。
  • branchやpathの絞り込みでスキップされたworkflowは、チェックが「Pending」のまま残り、そのチェックを必須にしているPRはmergeできなくなることがあります。

出典: Triggering a workflow、Events that trigger workflows/確認日 2026年11月2日

ログの開き方と再実行の方法

  1. リポジトリの「Actions」タブを開き、左のサイドバーでworkflowを選びます。
  2. 実行の一覧から対象の実行を開き、「Jobs」から失敗したjobを選びます。失敗したstepは自動で展開されます。
  3. ログの右上の「Search logs」で検索できますが、検索の対象は展開されているstepだけです。歯車のメニューの「Download log archive」で、ログをまとめて保存できます。一部のjobだけを再実行した場合、アーカイブには再実行したjobのログしか入りません。

GitHub CLIなら、gh run view 実行ID --log でログを表示でき、gh run view --job ジョブID --log-failed で失敗したstepだけを表示できます。

再実行は、実行の概要画面の「Re-run jobs」から、すべてのjob、失敗したjobだけ、または1つのjobを選べます。CLIでは gh run rerun 実行ID、失敗分だけなら --failed です。公式によると、再実行できるのは最初の実行から30日以内で、1つの実行につき最大50回までです。再実行は元と同じ GITHUB_SHA と GITHUB_REF を使い、権限は最初に起動した人のものが使われます。詳しいログが必要な時は、「Enable debug logging」を選んでから再実行します(CLIでは --debug)。なお、workflowが無効になっている間は再実行できません。

出典: Using workflow run logs、Re-running workflows and jobs/確認日 2026年11月2日

関連ページ