Saltar al contenido

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

  1. 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.
  2. Compruebe que una etiqueta existe antes de referenciarla.
  3. Haga un fork o incorpore en su repositorio las acciones de terceros de las que dependan sus pipelines importantes.
  4. 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.