GitHub Actions supprime Node.js 20 : Comment auditer et corriger vos workflows
GitHub Actions ne fournit plus l'environnement d'exécution Node.js 20 pour les actions JavaScript. Même si votre application n'utilise pas Node.js, un ancien checkout, setup ou action tierce peut désormais devenir un problème d'intégration continue. Voici comment auditer vos workflows, mettre à jour les actions personnalisées et vérifier en toute sécurité les runners auto-hébergés.
GitHub Actions a abandonné Node.js 20 : comment auditer et corriger vos workflows
Un workflow GitHub Actions peut dépendre de Node.js, même si le projet qu'il construit ne contient pas de code JavaScript.
Ce détail est devenu crucial.
Le 23 septembre 2026, GitHub a finalisé le retrait de Node.js 20 des runners GitHub Actions. Les actions JavaScript s'exécutent désormais sur Node.js 24, et l'option temporaire permettant aux utilisateurs de rester sur Node 20 n'est plus disponible.
Pour de nombreux dépôts, aucun changement n'est nécessaire. Les versions actuelles des actions de première partie de GitHub sont déjà passées à Node 24.
Cependant, les workflows plus anciens, les actions JavaScript personnalisées et certains runners auto-hébergés nécessitent un audit.
La distinction essentielle est de comprendre sur quel runtime Node.js GitHub parle.
Le runtime de votre application et celui de votre action sont deux éléments distincts
Prenons l'exemple d'un projet PHP avec ce workflow :
steps:
- uses: actions/checkout@v4
- name: Install dependencies
run: composer install
- name: Run tests
run: vendor/bin/phpunit
L'application est écrite en PHP. Cependant, actions/checkout est une action JavaScript. GitHub exécute son code JavaScript en utilisant un runtime Node.js intégré au runner Actions.
Ce runtime est indépendant de l'installation de Node.js effectuée par votre workflow. De même, actions/setup-node peut installer Node 22 pour les commandes ultérieures du workflow, tandis que l'action elle-même s'exécute avec le runtime déclaré dans ses métadonnées.
Cette distinction explique pourquoi le retrait de Node 20 peut affecter des projets non liés à Node.js, tels que PHP, Python, Go, Java, etc.
Qu'est-ce qui a exactement changé ?
GitHub a annoncé la dépréciation de Node 20 bien à l'avance, car Node.js 20 est devenu obsolète en avril 2026. GitHub a commencé à basculer les actions vers Node 24 par défaut en juin 2026. Pendant cette période de transition, les utilisateurs pouvaient temporairement revenir au runtime obsolète grâce à ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION, mais il s'agissait seulement d'un moyen d'échapper à la migration.
Le 23 septembre 2026, GitHub a retiré Node 20 des runners GitHub Actions et a supprimé cette option. Si une action que vous maintenez utilise encore Node 20, GitHub recommande de la mettre à jour vers Node 24 et de publier une nouvelle version.
Premier audit : examinez chaque ligne uses:
Le premier audit d'un workflow commence dans .github/workflows. Recherchez uses: et recensez les actions de première et de troisième partie. Ne supposez pas qu'un workflow est à jour simplement parce qu'il s'exécute encore.
Pour chaque action, déterminez si la version référencée par votre workflow est une version actuelle qui prend en charge Node 24. Les actions de troisième partie méritent une attention particulière : vérifiez leur historique de versions avant de changer de version majeure sans précaution. Les entrées, les valeurs par défaut, les mécanismes d'authentification et le comportement du cache peuvent évoluer indépendamment de la migration Node.
Les actions JavaScript personnalisées nécessitent une correction différente
Si vous maintenez votre propre action JavaScript, examinez son action.yml ou action.yaml. Une action JavaScript peut encore contenir :
runs:
using: node20
main: dist/index.js
La déclaration de runtime doit cibler Node 24 :
runs:
using: node24
main: dist/index.js
Modifier cette ligne n'est que le début. Testez l'action sous Node 24, mettez à jour les dépendances si nécessaire et reconstruisez tout bundle dist/ engagé. Sinon, les consommateurs peuvent continuer à exécuter du code JavaScript généré de manière obsolète, même si la source a changé.
Une migration sûre consiste à mettre à jour l'environnement de développement, à mettre à jour les dépendances, à modifier runs.using, à reconstruire le code JavaScript distribué, à exécuter les tests, à tester l'action dans un workflow réel et à publier une nouvelle version.
Les runners auto-hébergés nécessitent une attention particulière
Les runners hébergés par GitHub sont gérés par GitHub. Les runners auto-hébergés sont différents. L'application du runner inclut les exécutables Node.js utilisés par les actions JavaScript, ce qui rend la version du runner importante. Les dernières versions des actions basées sur Node 24 nécessitent un Actions Runner suffisamment récent.
Si votre organisation utilise des runners auto-hébergés, incluez leurs versions, systèmes d'exploitation et architectures dans l'audit de migration, plutôt que de ne regarder que le fichier YAML des workflows. Les anciens systèmes d'exploitation peuvent devenir un obstacle caché, car Node 24 modifie la base de plateformes prises en charge.
CodeQL a son propre chemin de migration
Les dépôts utilisant l'analyse de code de GitHub doivent également examiner leur workflow CodeQL. CodeQL Action v4 utilise le runtime Node.js 24. Les configurations avancées de CodeQL doivent donc être vérifiées pour d'anciennes références github/codeql-action et migrées conformément aux directives de compatibilité actuelles de GitHub.
Une commande d'audit utile
Sur une machine de développement de type Unix, un premier passage rapide peut s'effectuer comme suit :
grep -R "uses:" .github/workflows
Pour les actions personnalisées dans le dépôt :
grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"
Ces recherches ne garantissent pas la compatibilité, mais elles fournissent un inventaire efficace. L'objectif est de répondre à trois questions : quelles actions sont utilisées, quelles versions sont verrouillées, et quelles actions personnalisées utilisent encore un runtime obsolète ?
Faut-il verrouiller les actions sur des balises ou des SHAs de commit ?
Une migration de runtime est également une bonne occasion de revoir l'hygiène de la chaîne d'approvisionnement. Une référence telle que vendor/action@v4 peut être déplacée par son mainteneur, tandis qu'un SHA de commit complet identifie une révision immuable.
Pour les workflows sensibles à la sécurité, verrouiller les actions de tierce partie sur des SHAs de commit complets peut réduire le risque de modifications de code inattendues. Le compromis est la maintenance : les mises à jour nécessitent alors un processus délibéré ou un outil de gestion des dépendances.
Soyez particulièrement prudent avec les workflows de pull-request privilégiés
Mettre à jour les anciennes actions est important, mais le modèle de sécurité des workflows l'est encore plus. pull_request_target peut s'exécuter avec accès au jeton, aux secrets et au cache du dépôt de base. Vérifier du code de pull-request contrôlé par un attaquant à l'intérieur d'un tel workflow privilégié peut créer une grave vulnérabilité dans la chaîne d'approvisionnement.
Lors de l'audit des fichiers de workflow pour Node 24, examinez leurs déclencheurs et leurs autorisations simultanément. Un runtime moderne ne rend pas un workflow insécure sécurisé.
Une liste de contrôle de migration pratique
Commencez par lister toutes les références uses: dans .github/workflows. Mettez à jour les actions de première partie obsolètes après avoir consulté les notes de version. Vérifiez chaque action de tierce partie pour une version maintenue compatible avec Node 24. Recherchez dans les métadonnées des actions personnalisées node20, migrez-le vers node24, reconstruisez les bundles et effectuez des tests.
Pour les runners auto-hébergés, vérifiez la version du runner, le système d'exploitation et l'architecture. Examinez les workflows avancés de CodeQL. Enfin, testez les workflows importants de publication, planifiés et de déploiement, ainsi que le chemin CI par défaut, car ce sont souvent les jobs peu utilisés où les anciennes versions d'actions persistent.
Pourquoi cette migration vaut la peine d'être effectuée correctement
Les migrations de runtime Node.js dans GitHub Actions peuvent sembler être le problème de l'infrastructure d'autrui, mais ce n'est pas le cas. Les actions sont des dépendances exécutables dans votre système CI/CD. Elles peuvent construire des versions, gérer des identifiants, télécharger des artefacts et déployer des applications de production.
Le passage de GitHub de Node 20 à Node 24 est donc un rappel utile que les dépendances CI ont des cycles de vie, tout comme les dépendances des applications.
La tâche immédiate est simple : supprimer les dépendances restantes envers les actions JavaScript obsolètes et mettre à jour l'infrastructure auto-hébergée si nécessaire. La leçon à long terme est plus précieuse : traitez .github/workflows comme une infrastructure d'application maintenue, et non comme une configuration qui peut être écrite une fois et oubliée.
Un dépôt qui audite régulièrement ses actions, versions de runners, autorisations et dépendances de tierce partie sera bien mieux préparé pour la prochaine transition de runtime et considérablement plus sûr entre les migrations.