終了コード128で失敗したプロセス '/usr/bin/git'
最終更新:
The process '/usr/bin/git' failed with exit code 128は、gitが致命的なエラーに遭遇して停止したことを意味します。終了コード128はgitの「fatal」を表すコードです。原因は直前のfatal:の行に示されています。主な発生箇所はactions/checkoutまたはrunステップ内のgitコマンドで、一般的な原因は認証、存在しないref、履歴が不足しているshallow clone、コンテナ内のファイル所有者の不一致です。
表示される正確なメッセージ
Error: The process '/usr/bin/git' failed with exit code 128
その直前の行を確認してください。代表的なものを、それぞれの修正方法とともに以下に示します。
fatal: could not read UsernameまたはAuthentication failed
ジョブにプライベートリポジトリへのアクセス用の認証情報が必要です。could not read UsernameとPermission denied (publickey)を参照してください。
fatal: リポジトリ '...' が見つかりません
repository:の入力値が誤っているか、リポジトリの名前が変更または削除されたか、トークンがそのリポジトリを参照できないことが考えられます。GitHubは、アクセス権のないプライベートリポジトリを「not found」として報告します。スペルとトークンのアクセス権を確認してください。
fatal: couldn't find remote refまたはpathspec ... did not match
指定したブランチ、タグ、SHAがそのリポジトリに存在しません。プルリクエストのマージ後にブランチが削除された場合、ref:が古い名前を指している場合、またはタグがプッシュされていない場合に発生します。
- uses: actions/checkout@v4
with:
ref: ${{ github.event.pull_request.head.sha }}
フォークからのプルリクエストでは、head ブランチがフォーク側に存在するため、refと併せてrepository: ${{ github.event.pull_request.head.repo.full_name }}を使用してください。また、シークレットを使ってフォークのコードを実行する場合のセキュリティ上の影響にも注意してください。
shallow clone後にfatal: ... unknown revisionが発生する
デフォルトではactions/checkoutは単一のコミットのみを取得します。そのため、git log main..HEAD、git describe、git diff origin/main、変更履歴の生成ツールなどは、履歴が不足しているため失敗します。履歴を追加で取得してください。
- uses: actions/checkout@v4
with:
fetch-depth: 0 # full history and tags
fetch-depth: 0はすべての履歴を取得しますが、大規模なリポジトリでは時間がかかります。必要な分だけ増やす場合はfetch-depth: 50のように数値を指定するか、コマンドの前にgit fetch --depth=200 origin mainを実行してください。
fatal: リポジトリに安全でない所有権が検出されました
container:で実行されるジョブでは、ワークスペースの所有者がgitを実行するユーザーと異なるため、gitがそのワークスペースでの操作を拒否します。次のように安全なディレクトリとして登録してください。
- run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
最近のバージョンのactions/checkoutでは、多くの場合これが自動で行われます。そのため、現在のメジャーバージョンを使用しているかも確認してください。
fatal: Gitリポジトリではありません
checkoutより前にステップが実行されたか、誤ったディレクトリで実行されています。actions/checkoutを先に追加し、working-directoryを確認してください。
fatal: ... にアクセスできません。要求されたURLがエラー 403 を返しました
通常、適切なトークンの権限がないままpushまたはfetchを行ったことが原因です。[Permission denied to github-actions[bot]](/errors/permission-to-repo-denied-to-github-actions-bot)を参照してください。
サブモジュール
サブモジュールの取得が失敗した場合も、終了コード128になります。サブモジュールのURLがプライベートである(トークンが必要)、上流に存在しなくなったコミットを指している、またはSSHを使用している可能性があります。ローカルでgit submodule statusを実行し、固定されている各コミットがリモートに存在するか確認してください。
予防方法
actions/checkoutを現在のメジャーバージョンに固定し、終了コードだけでなくfatal:の行を確認してください。- 履歴を読み取るステップでは、
fetch-depthを意図的に設定してください。 - 現在のリポジトリ以外にアクセスする場合は、範囲を限定したトークンを使用してください。
- 削除されるブランチへのワークフロー内の参照を削除し、プルリクエストのビルドではSHAを使用してください。
- サブモジュールのポインタは、プッシュ済みのコミットに固定しておいてください。
よくある質問
gitの終了コード128は何を意味しますか?
致命的なエラーです。gitはその内容を説明するfatal:メッセージを出力し、128で終了します。
なぜ/usr/bin/gitと表示されるのですか?
actions/checkoutなどのアクションは、gitを子プロセスとして実行します。ランナーは、どのプロセスが何のコードで失敗したかを報告します。
GitHubの障害ですか?
無関係な多数のワークフローが同時に取得処理で失敗する場合は、GitHubのステータスページを確認してください。それ以外の場合は、fatal:の行がお使いの設定の問題を示しています。
再実行すればよいですか?
メッセージがネットワークエラーやサーバーエラー(RPC failedやearly EOFなど)に見える場合にのみ再実行してください。認証エラーや存在しないrefのエラーは、再実行しても再び失敗します。
関連記事
- 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 Actionsの終了コード137: メモリ不足の修正方法GitHub Actionsで「Process completed with exit code 137」と表示される場合、SIGKILLによる強制終了を意味し、多くはメモリ不足が原因です。Node、Jest、Gradle、DockerのRAM対策と、ランナーのRAMについて説明します。