GitHub Actionsのエラーと対処法
正確なエラーメッセージ、その原因、動作するYAMLによる対処法を説明します。
- Cache Service Responded With 429: 修正方法GitHub Actions の「Failed to restore: Cache service responded with 429」を修正します。キャッシュへのリクエストが多すぎる場合の対処法です。actions/cache を更新し、復元は何度行っても構いませんが、保存は一度だけにしてください。
- fatal: could not read Username for github.com: 修正方法GitHub Actionsで"fatal: could not read Username for 'https://github.com'"を解決する方法:プライベートリポジトリ、サブモジュール、gitの依存関係にはトークンが必要です。
- Invalid Workflow File: YAML構文エラーの修正方法GitHub Actionsで"Invalid workflow file"と"You have an error in your yaml syntax"を解決する方法:インデント、予期しない値、不正な式をactionlintで確認します。
- GitHub ActionsでのJavaScript Heap Out of Memoryの修正方法GitHub ActionsでNODE_OPTIONSを使い、"FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory"とnpm ENOMEMを解決する方法。
- GitHub ActionsでのPermission Denied (publickey)の修正方法GitHub Actionsで"git@github.com: Permission denied (publickey)"を解決する方法:SSHキーまたはデプロイキーを追加するか、プライベートリポジトリ向けにHTTPSトークンへ切り替えます。
- github-actions[bot]によるアクセス拒否(403): 修正方法ワークフローがプッシュする際に発生する「github-actions[bot]によるrepo.gitへのアクセス権がありません」(403)の修正: contentsの書き込み権限を設定し、ブランチルールとフォークの制限を確認してください。
- exit code 1で終了しました:デバッグ方法GitHub Actionsの「Process completed with exit code 1」は、コマンドが失敗したことを意味します。その上にある本当のエラーを見つけ、デバッグし、よくある原因を修正する方法を説明します。
- Process Completed With Exit Code 127:コマンドが見つからないGitHub Actionsの「Process completed with exit code 127」を修正する方法:コマンドが見つからない場合です。ツールの不足、ステップ間のPATH、スクリプトパスの誤り、CRLFの改行コードについて説明します。
- Process Completed With Exit Code 143:SIGTERMの修正GitHub Actionsで「Process completed with exit code 143」を修正します。キャンセル、タイムアウト、ランナーのシャットダウン、docker stopによるSIGTERMの原因と対処方法を説明します。
- GitHub Appによるワークフローの更新を拒否される:修正方法「refusing to allow a GitHub App to create or update workflow without workflows permission」の修正方法:ワークフローへの書き込み権限を持つPATまたはAppトークンを使用してください。
- Resource Not Accessible by Integration: 修正方法GitHub Actionsで「Resource not accessible by integration」(HTTP 403)を修正する方法を解説します。GITHUB_TOKENの権限設定、フォークやDependabotのPRへの対応を説明します。
- 終了コード128で失敗したプロセス '/usr/bin/git'GitHub Actionsで「The process '/usr/bin/git' failed with exit code 128」を解決します。認証、不足しているref、シャローclone、所有者の不一致(dubious ownership)について修正方法を説明します。
- ランナーがシャットダウンシグナルを受信しました: 修正方法GitHub Actionsで「The runner has received a shutdown signal」が出る原因と修正方法を解説します。スポットインスタンス、オートスケーリング、停止したランナーサービス、退避されたPodが対象です。
- アクションを解決できません: バージョンが見つかりませんGitHub Actionsで「Unable to resolve action ... unable to find version」が出る場合の対処法です。誤ったタグ、削除されたアクション、プライベートリポジトリへのアクセス、許可リストのルールを確認します。
- GitHub Actionsでの API レート制限超過: 対処法GitHub Actionsで「API rate limit exceeded for installation ID」を解決します。GITHUB_TOKENはリポジトリごとに1時間あたり1,000リクエストまで。セカンダリ制限と対処法を解説します。
- Cache not found for input keys: 原因と対処法GitHub Actions の「Cache not found for input keys」はキャッシュミスであり、必ずしもエラーではありません。発生する理由、key と branch の適用範囲の仕組み、対処法を解説します。
- GitHub ActionsでのDockerのPullレート制限:対処法GitHub Actionsで「toomanyrequests: You have reached your pull rate limit」を解決する方法:Docker Hubの制限、docker/login-action、ミラー、GHCRの代替手段について解説します。
- 360分の最大実行時間を超過: 修正方法「runner上で実行中のジョブが最大実行時間の360分を超えました」を修正します。ジョブとステップにtimeout-minutesを設定し、停止している箇所を特定します。
- GitHub Actionsの終了コード137: メモリ不足の修正方法GitHub Actionsで「Process completed with exit code 137」と表示される場合、SIGKILLによる強制終了を意味し、多くはメモリ不足が原因です。Node、Jest、Gradle、DockerのRAM対策と、ランナーのRAMについて説明します。
- ホストランナーがサーバーとの通信を失った場合の対処法GitHub Actionsでランナーがサーバーとの通信を失いましたか?多くの場合、メモリ不足またはディスクの空き容量不足が原因です。原因を特定し、YAMLで修正する方法を解説します。
- ジョブが開始されない: 最近のアカウント支払いが失敗しましたGitHub Actionsで「最近のアカウント支払いが失敗したか、利用上限の引き上げが必要なため、ジョブは開始されませんでした」というエラーを解決する方法。
- GitHub Actionsでの「No space left on device」の対処法GitHub Actionsの「No space left on device」を解決します。ランナーのディスク容量、容量を消費する要因、安全なクリーンアップ手順、Docker pruneと大型ランナーについて説明します。
- GitHub Actionsで「The operation was canceled」が出る原因GitHub Actionsの「The operation was canceled」エラーを解消します。concurrencyのcancel-in-progress、timeout、matrixのfail-fast、ランナーのシャットダウンを、YAMLの例とともに解説します。
- ランナーがジョブを取得するのを待っています:対処法GitHub Actionsで「Waiting for a runner to pick up this job」が表示される原因と対処法を解説します。プランごとの同時実行数制限、runs-onラベルの不一致、オフラインのセルフホステッドランナーを取り上げます。