サービス
GitHub Actions
GitHub に統合された CI/CD・ワークフロー自動化サービス。.github/workflows/ 配下の YAML でジョブを定義し push や pull_request、cron などのイベントで runner 上で実行する。トリガ条件、secrets / GITHUB_TOKEN の権限、actions/cache、再利用可能ワークフローなど Actions 固有の問題を扱い、リポジトリ管理や PR 操作自体は GitHub 本体が担当する。
問題一覧(10)
GitHub Actions のキャッシュが復元されない
actions/cache の key 不一致、ブランチ間の参照ルール、リポジトリの容量上限(既定 10 GB)超過、7 日間未参照での自動削除が主因。job ログの Cache not found for input keys: 行で実際に検索された key を確認するのが起点。
更新: 2026-10-05、タグ: cache、ci、workflow
GitHub Actions の GITHUB_TOKEN で push や API が 403 になる
GitHub Actions で push や API が 403 になるときは、ワークフローの permissions: で必要な権限を明示すれば直る。GITHUB_TOKEN は既定で読み取り専用に絞られている。
更新: 2026-10-05、タグ: github-token、permissions、push
GitHub Actions の set-output deprecation 警告が消えない
set-output の deprecation 警告は、$GITHUB_OUTPUT への追記に書き換えれば消える。自前のステップのほか、古い actions/cache@v2 などに残っていることも多い。
更新: 2026-11-09、タグ: workflow、deprecated、output
GitHub Actions のワークフローが push / PR で起動しない
ワークフローファイルの配置パス・トリガー名の typo・branches / paths フィルタのいずれかが原因で発火対象から外れている可能性が高い。Actions タブの All workflows 一覧に名前が出るかをまず確認する。
更新: 2026-10-06、タグ: workflow、trigger、ci
GitHub Actions でステップ間に環境変数が引き継げない
run 内の export は各ステップ独立のシェルプロセス内でしか有効でない。後続ステップへは GITHUB_ENV への追記、ジョブをまたぐ場合は jobs.outputs と needs を使うのが正しい受け渡し方法。
更新: 2026-11-13、タグ: env、github-env、outputs
GitHub Actions の if 条件どおりにステップを実行できない
if が効かないときは、前ステップ失敗時に暗黙で付く success() 条件、文字列 'false' を真と評価する型の取り違え、! で始まる式のクオート漏れを順に疑う。failure() / always() の明示と式の ${{ }} 囲みで大半は解決する。
更新: 2026-10-05、タグ: if、conditional、expressions
GitHub Actions の matrix で 1 件失敗すると他のジョブが実行できない
matrix の strategy.fail-fast は既定で true のため、1 つのジョブが失敗すると進行中・待機中の他ジョブはすべてキャンセルされる。fail-fast: false で全件完走させるか、continue-on-error で特定ジョブの失敗を許容する。
更新: 2026-10-05、タグ: matrix、fail-fast、strategy
GitHub Actions の schedule(cron)が定刻に実行されない
schedule トリガはデフォルトブランチでのみ動き、高負荷時間帯は遅延し、public リポジトリでは 60 日間活動が無いと自動無効化される。cron は既定で UTC 基準なので JST との 9 時間差にも注意する。
更新: 2026-10-29、タグ: schedule、cron、workflow
Fork からの PR で GitHub Actions の Secrets が使えない
セキュリティ上、pull_request イベントは fork 側のワークフローに secrets を渡さない仕様。pull_request_target への切り替え、信頼境界を切り分けたジョブ設計、Environments での承認ゲートを組み合わせて安全に解決する。
更新: 2026-10-07、タグ: secrets、fork、workflow
GitHub Actions の workflow_dispatch で手動実行できない(Run workflow が出ない)
Run workflow ボタンが出ないのは、workflow_dispatch を含むワークフローがデフォルトブランチに無いのが主因。ほかに on: の構文ミス、ワークフローの無効化、権限不足でも手動実行できなくなる。
更新: 2026-10-05、タグ: workflow-dispatch、trigger、manual