アクションを解決できません: バージョンが見つかりません
最終更新:
Unable to resolve actionは、uses:行が指しているアクションをGitHubがダウンロードできなかったことを意味します。そのため、ステップが一つも実行される前にジョブが失敗します。原因は、アクションの参照先(オーナー、リポジトリ、パス、バージョン)が存在しないか、ワークフローがそれを参照することを許可されていないかのどちらかです。このページでは両方を扱います。
表示される正確なメッセージ
Error: Unable to resolve action `actions/checkout@v9`, unable to find version `v9`
Error: Unable to resolve action `some-org/some-action@v1`, repository not found
Error: Unable to resolve action `owner/repo@main`, unable to find version `main`
原因1: バージョンが存在しない
@の後のタグ、ブランチ、またはコミットがそのリポジトリに存在しません。典型的な理由は、タイプミス、作成者が公開していないメジャータグ(v3.1.0しかないのにv3を指定している場合など)、または削除されたか移動されたタグです。GitHubでリポジトリのタグとリリースを確認するか、次のコマンドで一覧を表示してください:
git ls-remote --tags https://github.com/actions/checkout | tail
その後、存在するものに固定してください:
- uses: actions/checkout@v4
# or, safer, a full commit SHA with the version in a comment:
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
原因2: リポジトリの名前変更、移動、または削除
以前は動いていたアクションでrepository not foundが出る場合、オーナーが名前を変更したか、アーカイブして削除したか、プライベート化したことを意味します。新しい場所を検索するか、別のアクションや単純なrunステップに置き換えてください。
原因3: アクセスできないプライベートリポジトリ内のアクション
プライベートリポジトリのアクションは、それを参照することが許可されたワークフローからのみ使用できます。アクションのリポジトリで「Settings」「Actions」「General」に進み、「Access」で、組織(またはユーザーアカウント)内の他のリポジトリからのアクセスを許可する設定を選んでください。別の組織のワークフローからはこの方法では使用できません。その場合は、アクションを公開するか、それを使用するリポジトリにコピーしてください。
原因4: 組織が実行できるアクションを制限している
組織またはリポジトリのポリシーが特定のアクションのみを許可している場合、ブロックされたアクションは解決に失敗するか、そのアクションが許可されていないというメッセージとともに拒否されます。「Settings」「Actions」「General」の「Actions permissions」でポリシーを確認できます。組織のオーナーにそのアクションを許可リストに追加してもらうか、すでに許可されているものを使用してください。
原因5: checkoutなしのローカルアクション
uses: ./.github/actions/setupのようなローカルアクションでは、先にコードがランナー上にある必要があります。その前にactions/checkoutを追加してください。これがないと、通常はこのエラーではなく「Can't find 'action.yml'」が出ますが、対処法は同じです。
原因6: サブディレクトリ内のアクションのパスが誤っている
サブフォルダ内のアクションの場合、形式はowner/repo/path@refです。パスが欠けているか、フォルダ名が誤っていると解決に失敗します。
- uses: github/codeql-action/init@v3
原因7: 再利用可能ワークフローの参照
uses: org/repo/.github/workflows/build.yml@mainの場合、パスはワークフローファイル名で終わる必要があり、そのファイルは指定したref上に存在しなければならず、呼び出し元のワークフローがそれにアクセスすることを許可されている必要があります(プライベートアクションと同じアクセスルール)。
予防方法
- アクションは完全なコミットSHAに固定し、バージョンをコメントで記載したうえで、Dependabotに更新させてください。Dependabotのセットアップを参照してください。
- 参照する前に、タグが存在することを確認してください。
- 重要なパイプラインで依存しているサードパーティのアクションは、フォークするかベンダリングしてください。
- 新しいアクションを追加するときに許可リストを確認してください。ビルドが壊れてからではなく、事前に確認することが大切です。
よくある質問
GitHubの障害でしょうか?
ほとんどの場合、違います。関係のない多くのワークフローが一斉にアクションのダウンロードに失敗する場合は、GitHubのステータスページを確認してください。
なぜ一つのアクションでは@v4が動くのに、別のアクションでは@v1が失敗するのでしょうか?
各リポジトリが独自にタグを決めるためです。v1のような、移動するメジャータグを公開していないアクションもあります。
ブランチ名は使えますか?
はい。ブランチが存在すれば@mainは動作しますが、移動するブランチは内容が変わることがあります。SHAの方が安全です。
どのアクションが失敗したかを確認するには?
エラーメッセージはバッククォートで名前を示しています。「Set up job」ステップで最初に失敗している行に、正確なowner/repo@refが表示されます。
関連記事
- 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を解決する方法。