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