No se puede resolver la acción: no se encuentra la versión
Última actualización:
Unable to resolve action significa que GitHub no pudo descargar la acción a la que apunta su línea uses:, por lo que el job falló antes de ejecutar cualquier paso. Puede que la referencia a la acción (propietario, repositorio, ruta o versión) no exista, o que el workflow no tenga permiso para acceder a ella. Esta página cubre ambos casos.
El mensaje exacto
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`
Causa 1: la versión no existe
La etiqueta, rama o commit que aparece después de @ no está en ese repositorio. Los motivos habituales son un error tipográfico, una etiqueta de versión mayor que el autor nunca publicó (v3 cuando solo existe v3.1.0) o una etiqueta eliminada o movida. Revise las etiquetas y versiones del repositorio en GitHub, o enumérelas:
git ls-remote --tags https://github.com/actions/checkout | tail
Después, fije la referencia a una versión que exista:
- uses: actions/checkout@v4
# or, safer, a full commit SHA with the version in a comment:
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
Causa 2: el repositorio fue renombrado, movido o eliminado
repository not found en una acción que antes funcionaba significa que el propietario la renombró, la archivó y eliminó, o la hizo privada. Busque su nueva ubicación o sustitúyala por otra acción o por un paso run normal.
Causa 3: la acción está en un repositorio privado al que no tiene acceso
Una acción alojada en un repositorio privado solo puede usarla un workflow que tenga permiso para verla. En el repositorio de la acción, vaya a Settings, Actions, General y, en "Access", elija permitir el acceso desde otros repositorios de su organización (o cuenta de usuario). Un workflow de otra organización no puede usarla de este modo: publique la acción como pública o cópiela en el repositorio que la utiliza.
Causa 4: su organización restringe qué acciones pueden ejecutarse
Si la política de la organización o del repositorio permite solo determinadas acciones, una acción bloqueada no se resuelve o se rechaza con un mensaje indicando que no está permitida. En Settings, Actions, General, "Actions permissions" muestra la política vigente. Pida a un propietario de la organización que añada la acción a la lista de permitidas o use una que ya lo esté.
Causa 5: una acción local sin checkout
En una acción local, como uses: ./.github/actions/setup, el código debe estar primero en el runner. Añada actions/checkout antes de ella. Sin ese paso, el error suele ser "Can't find 'action.yml'" y no este, pero la solución es la misma.
Causa 6: ruta incorrecta para una acción en un subdirectorio
En el caso de acciones situadas en una subcarpeta, el formato es owner/repo/path@ref. Una ruta que falta o un nombre de carpeta incorrecto impiden la resolución.
- uses: github/codeql-action/init@v3
Causa 7: referencia a un workflow reutilizable
En uses: org/repo/.github/workflows/build.yml@main, la ruta debe terminar en el nombre del archivo del workflow, el archivo debe existir en esa referencia y el workflow que llama debe tener permiso para acceder a él (las mismas reglas de acceso que las acciones privadas).
Cómo prevenirlo
- Fije las acciones a un SHA de commit completo, con un comentario para la versión, y deje que Dependabot las actualice. Consulte Configuración de Dependabot.
- Compruebe que una etiqueta existe antes de referenciarla.
- Haga un fork o incorpore en su repositorio las acciones de terceros de las que dependan sus pipelines importantes.
- Revise la lista de permitidas al añadir una nueva acción, no cuando la compilación falle.
Preguntas frecuentes
¿Es una caída de GitHub?
Casi nunca. Si muchos workflows no relacionados fallan al descargar acciones a la vez, consulte la página de estado de GitHub.
¿Por qué @v4 funciona con una acción y @v1 falla con otra?
Cada repositorio elige sus propias etiquetas. No todas las acciones publican etiquetas de versión mayor móviles como v1.
¿Puedo usar el nombre de una rama?
Sí, @main funciona si la rama existe, pero una rama móvil puede cambiar sin previo aviso. Un SHA es más seguro.
¿Cómo encuentro qué acción falló?
El mensaje la nombra entre comillas invertidas. La primera línea con error en el paso "Set up job" muestra el owner/repo@ref exacto.
Relacionado
- Cache Service Responded With 429: Cómo solucionarloSolucione "Failed to restore: Cache service responded with 429" en GitHub Actions: demasiadas solicitudes de caché. Actualice actions/cache y restaure y guarde una vez.
- fatal: could not read Username for github.com: SoluciónSolucione "fatal: could not read Username for 'https://github.com'" en GitHub Actions: repos privados, submódulos y dependencias git necesitan un token.
- Archivo de flujo de trabajo no válido: cómo solucionar el error de sintaxis YAMLCorrija "Invalid workflow file" y "You have an error in your yaml syntax" en GitHub Actions: sangría, valor inesperado, expresiones erróneas, con actionlint.
- JavaScript Heap Out of Memory en GitHub Actions: soluciónSolucione "FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory" y npm ENOMEM en GitHub Actions con NODE_OPTIONS.