GitHub Actions elimina Node.js 20: Cómo auditar y corregir tus flujos de trabajo
GitHub Actions ya no proporciona el runtime de Node.js 20 para acciones de JavaScript. Incluso si tu aplicación no usa Node.js, un checkout antiguo, setup o acción de terceros puede convertirse ahora en un problema de CI. Aquí tienes cómo auditar tus flujos de trabajo, actualizar acciones personalizadas y verificar los ejecutores autoalojados de forma segura.
GitHub Actions eliminó Node.js 20: Cómo auditar y corregir tus workflows
Un workflow de GitHub Actions puede depender de Node.js incluso cuando el proyecto que construye no contiene JavaScript en absoluto.
Ese detalle se ha vuelto importante.
El 23 de septiembre de 2026, GitHub completó la eliminación de Node.js 20 de los runners de GitHub Actions. Las actions de JavaScript ahora se ejecutan en Node.js 24, y el interruptor de compatibilidad temporal que anteriormente permitía a los usuarios permanecer en Node 20 ya no está disponible.
Para muchos repositorios, no es necesario cambiar nada. Las versiones actuales de las actions de primera parte de GitHub ya se han migrado a Node 24.
Sin embargo, los workflows antiguos, las actions de JavaScript personalizadas y algunos runners autoalojados merecen una auditoría.
La distinción importante es entender qué runtime de Node.js es el que GitHub menciona.
Tu runtime de aplicación y tu runtime de Action son cosas diferentes
Considera un proyecto PHP con este workflow:
steps:
- uses: actions/checkout@v4
- name: Install dependencies
run: composer install
- name: Run tests
run: vendor/bin/phpunit
La aplicación es PHP. Pero actions/checkout es en sí misma una action de JavaScript. GitHub ejecuta su JavaScript usando un runtime de Node.js incluido con el runner de Actions.
Ese runtime es independiente de Node.js instalado por tu workflow. Del mismo modo, actions/setup-node puede instalar Node 22 para los comandos subsiguientes del workflow mientras la action se ejecuta con el runtime declarado en sus metadatos.
Esa distinción explica por qué la eliminación de Node 20 potencialmente afecta a proyectos PHP, Python, Go, Java y otros proyectos que no son de Node.
¿Qué cambió exactamente?
GitHub anunció la obsolescencia de Node 20 con bastante antelación porque Node.js 20 llegó al fin de su vida útil en abril de 2026. GitHub comenzó a cambiar Actions a Node 24 por defecto en junio de 2026. Durante el período de migración, los usuarios podían optar temporalmente por volver al runtime obsoleto con ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION. Eso era solo una vía de escape para la migración.
El 23 de septiembre de 2026, GitHub eliminó Node 20 de los runners de GitHub Actions y eliminó esa opción de exclusión. Si una action que mantienes aún declara Node 20, la recomendación de GitHub es actualizarla a Node 24 y publicar una nueva versión.
Primera auditoría: inspecciona cada línea uses:
La auditoría de workflow más simple comienza en .github/workflows. Busca uses: y haz un inventario de las actions de primera parte y de terceros. No asumas que un workflow está actualizado meramente porque siga funcionando.
Para cada action, determina si la versión referenciada por tu workflow es una versión actual que soporta Node 24. Las actions de terceros merecen atención particular: revisa su historial de versiones antes de cambiar versiones mayores ciegamente. Entradas, valores por defecto, mecanismos de autenticación y comportamiento de caché pueden cambiar independientemente de la migración de Node.
Las actions de JavaScript personalizadas requieren una corrección diferente
Si mantienes tu propia action de JavaScript, inspecciona su action.yml o action.yaml. Una action de JavaScript puede contener aún:
runs:
using: node20
main: dist/index.js
La declaración del runtime debe apuntar a Node 24:
runs:
using: node24
main: dist/index.js
Cambiar esa línea es solo el comienzo. Prueba la action bajo Node 24, actualiza dependencias donde sea necesario y reconstruye cualquier bundle dist/ comprometido. De lo contrario, los consumidores pueden seguir ejecutando JavaScript generado antiguo aunque la fuente haya cambiado.
Una migración segura es actualizar el entorno de desarrollo, actualizar dependencias, cambiar runs.using, reconstruir el JavaScript distribuido, ejecutar pruebas, ejercitar la action en un workflow real y luego publicar una nueva versión.
Los runners autoalojados necesitan atención especial
Los runners alojados por GitHub son mantenidos por GitHub. Los runners autoalojados son diferentes. La aplicación del runner contiene los ejecutables de Node.js usados por las actions de JavaScript, lo que hace importante la versión del runner. Las versiones recientes de actions basadas en Node 24 requieren un Actions Runner suficientemente reciente.
Si tu organización opera runners autoalojados, incluye sus versiones, sistemas operativos y arquitecturas en la auditoría de migración en lugar de mirar solo el YAML del workflow. Los sistemas operativos antiguos pueden convertirse en el bloqueador oculto porque Node 24 cambia la línea base de plataformas soportadas.
CodeQL tiene su propia ruta de migración
Los repositorios que usan escaneo de código de GitHub deben inspeccionar también su workflow de CodeQL. CodeQL Action v4 usa el runtime de Node.js 24. Las configuraciones avanzadas de CodeQL deben verificarse por tanto para referencias github/codeql-action más antiguas y migrarse según la guía de compatibilidad actual de GitHub.
Un comando de auditoría útil
En una máquina de desarrollo tipo Unix, una primera pasada rápida es:
grep -R "uses:" .github/workflows
Para actions personalizadas dentro del repositorio:
grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"
Estas búsquedas no demuestran compatibilidad, pero proporcionan un inventario eficiente. El objetivo es responder tres preguntas: qué actions se usan, qué versiones están fijadas, y qué actions personalizadas aún declaran un runtime obsoleto.
¿Deben las actions fijarse a tags o SHAs de commit?
Una migración de runtime también es una buena oportunidad para revisar la higiene de la cadena de suministro. Una referencia como vendor/action@v4 puede ser movida por su mantenedor, mientras que un SHA de commit completo identifica una revisión inmutable.
Para workflows sensibles a la seguridad, fijar actions de terceros a SHAs de commit completos puede reducir el riesgo de cambios de código inesperados. El intercambio es el mantenimiento: las actualizaciones requieren entonces un proceso deliberado o herramientas de actualización de dependencias.
Ten especial cuidado con los workflows de pull request privilegiados
Actualizar actions antiguas es importante, pero el modelo de seguridad del workflow importa aún más. pull_request_target puede ejecutarse con acceso al token del repositorio base, secretos y caché. Hacer checkout de código de pull request controlado por un atacante dentro de un workflow privilegiado así puede crear una vulnerabilidad seria en la cadena de suministro.
Al auditar archivos de workflow para Node 24, inspecciona sus disparadores y permisos al mismo tiempo. Un runtime moderno no hace seguro un workflow inseguro.
Una lista de verificación de migración práctica
Comienza listando todas las referencias uses: en .github/workflows. Actualiza actions de primera parte obsoletas después de revisar las notas de versión. Verifica cada action de terceros para una versión mantenida compatible con Node 24. Busca en los metadatos de actions personalizadas node20, migra a node24, reconstruye bundles y prueba.
Para runners autoalojados, verifica versión del runner, sistema operativo y arquitectura. Revisa workflows avanzados de CodeQL. Finalmente, ejercita workflows importantes de release, programados y de despliegue, así como el camino CI por defecto, porque los jobs rara vez usados son donde a menudo sobreviven versiones antiguas de actions.
Por qué vale la pena hacer esta migración correctamente
Las migraciones de runtime de Node.js dentro de GitHub Actions pueden parecer un problema de infraestructura de otra persona. No lo son. Las actions son dependencias ejecutables en tu sistema CI/CD. Pueden construir releases, manejar credenciales, subir artefactos y desplegar aplicaciones de producción.
El movimiento de GitHub de Node 20 a Node 24 es por tanto un recordatorio útil de que las dependencias de CI tienen ciclos de vida igual que las dependencias de aplicación.
La tarea inmediata es directa: elimina las dependencias restantes en actions de JavaScript obsoletas y actualiza la infraestructura autoalojada donde sea necesario. La lección a largo plazo es más valiosa: trata .github/workflows como infraestructura de aplicación mantenida, no como configuración que se puede escribir una vez y olvidar.
Un repositorio que audita periódicamente sus actions, versiones de runner, permisos y dependencias de terceros estará mucho mejor preparado para la próxima transición de runtime—y considerablemente más seguro entre migraciones.