GitHub Actions hat Node.js 20 entfernt: So prüfen und beheben Sie Ihre Workflows
GitHub Actions bietet die Node.js 20 Laufzeit für JavaScript-Aktionen nicht mehr an. Auch wenn Ihre Anwendung Node.js nicht nutzt, kann ein älterer Checkout, Setup oder Drittanbieter-Aktion nun zu einem CI-Problem werden. So prüfen Sie Ihre Workflows, aktualisieren benutzerdefinierte Aktionen und prüfen selbstgehostete Runner sicher.
GitHub Actions hat Node.js 20 entfernt: So auditieren und beheben Sie Ihre Workflows
Ein GitHub Actions-Workflow kann von Node.js abhängen, selbst wenn das von ihm erstellte Projekt überhaupt kein JavaScript enthält.
Dieses Detail ist wichtig geworden.
Am 23. September 2026 hat GitHub die Entfernung von Node.js 20 von GitHub Actions-Runnern abgeschlossen. JavaScript-Actions laufen jetzt auf Node.js 24, und der vorübergehende Kompatibilitäts-Switch, der es Benutzern zuvor erlaubte, bei Node 20 zu bleiben, ist nicht mehr verfügbar.
Für viele Repositories muss nichts geändert werden. Aktuelle Versionen von GitHubs eigenen Actions sind bereits auf Node 24 umgestellt.
Ältere Workflows, benutzerdefinierte JavaScript-Actions und einige selbst gehostete Runner verdienen jedoch ein Audit.
Die wichtige Unterscheidung besteht darin zu verstehen, welche Node.js-Runtime GitHub meint.
Ihre Anwendungs-Runtime und Ihre Action-Runtime sind unterschiedliche Dinge
Betrachten Sie ein PHP-Projekt mit diesem Workflow:
steps:
- uses: actions/checkout@v4
- name: Install dependencies
run: composer install
- name: Run tests
run: vendor/bin/phpunit
Die Anwendung ist PHP. Aber actions/checkout ist selbst eine JavaScript-Action. GitHub führt deren JavaScript mit einer mit dem Actions-Runner gebündelten Node.js-Runtime aus.
Diese Runtime ist unabhängig von der von Ihrem Workflow installierten Node.js-Installation. Ebenso kann actions/setup-node Node 22 für nachfolgende Workflow-Befehle installieren, während die Action selbst mit der in ihren Metadaten deklarierten Runtime ausgeführt wird.
Diese Unterscheidung erklärt, warum die Entfernung von Node 20 potenziell PHP-, Python-, Go-, Java- und andere Nicht-Node-Projekte betrifft.
Was genau hat sich geändert?
GitHub kündigte die Node-20-Veraltung rechtzeitig im Voraus an, da Node.js 20 im April 2026 das Ende des Lebenszyklus erreichte. GitHub begann im Juni 2026, Actions standardmäßig auf Node 24 umzustellen. Während der Migrationsperiode konnten Nutzer vorübergehend mit ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION wieder in die veraltete Runtime einsteigen. Das war nur ein Migrations-Notausstieg.
Am 23. September 2026 entfernte GitHub Node 20 von GitHub Actions-Runnern und entfernte diese Ausstiegsoption. Wenn eine von Ihnen gewartete Action noch Node 20 deklariert, empfiehlt GitHub, sie auf Node 24 zu aktualisieren und eine neue Version zu veröffentlichen.
Erstes Audit: Überprüfen Sie jede uses:-Zeile
Das einfachste Workflow-Audit beginnt in .github/workflows. Suchen Sie nach uses: und erstellen Sie ein Inventar von GitHub-eigenen und Drittanbieter-Actions. Gehen Sie nicht davon aus, dass ein Workflow aktuell ist, nur weil er noch läuft.
Ermitteln Sie für jede Action, ob die von Ihrem Workflow referenzierte Version ein aktueller Release ist, der Node 24 unterstützt. Drittanbieter-Actions verdienen besondere Aufmerksamkeit: Überprüfen Sie deren Release-Historie, bevor Sie Hauptversionen blind ändern. Eingaben, Standardwerte, Authentifizierungsmechanismen und Cache-Verhalten können unabhängig von der Node-Migration ändern.
Benutzerdefinierte JavaScript-Actions erfordern eine andere Korrektur
Wenn Sie Ihre eigene JavaScript-Action warten, überprüfen Sie deren action.yml oder action.yaml. Eine JavaScript-Action kann noch Folgendes enthalten:
runs:
using: node20
main: dist/index.js
Die Runtime-Deklaration sollte auf Node 24 abzielen:
runs:
using: node24
main: dist/index.js
Die Änderung dieser Zeile ist erst der Anfang. Testen Sie die Action unter Node 24, aktualisieren Sie Abhängigkeiten bei Bedarf und erstellen Sie jedes committete dist/-Bundle neu. Andernfalls könnten Verbraucher weiterhin altes generiertes JavaScript ausführen, obwohl sich der Quellcode geändert hat.
Eine sichere Migration besteht darin, die Entwicklungsumgebung zu aktualisieren, Abhängigkeiten zu aktualisieren, runs.using zu ändern, das verteilte JavaScript neu zu erstellen, Tests auszuführen, die Action in einem realen Workflow zu testen und dann eine neue Version zu veröffentlichen.
Selbst gehostete Runner benötigen besondere Aufmerksamkeit
GitHub-gehostete Runner werden von GitHub gewartet. Selbst gehostete Runner sind anders. Die Runner-Anwendung enthält die von JavaScript-Actions verwendeten Node.js-Executables, wodurch die Runner-Version wichtig wird. Aktuelle auf Node 24 basierende Action-Releases erfordern einen ausreichend aktuellen Actions-Runner.
Wenn Ihre Organisation selbst gehostete Runner betreibt, nehmen Sie ihre Versionen, Betriebssysteme und Architekturen in das Migrations-Audit auf, anstatt nur auf Workflow-YAML zu schauen. Alte Betriebssysteme können zum versteckten Blocker werden, da Node 24 die unterstützte Plattformbasis ändert.
CodeQL hat einen eigenen Migrationspfad
Repositories, die GitHub-Code-Scanning verwenden, sollten auch ihren CodeQL-Workflow überprüfen. CodeQL Action v4 verwendet die Node.js-24-Runtime. Erweiterte CodeQL-Setups sollten daher auf ältere github/codeql-action-Verweise überprüft und gemäß GitHubs aktueller Kompatibilitätsanleitung migriert werden.
Ein nützliches Audit-Kommando
Auf einem unixähnlichen Entwicklungsrechner ist ein schneller erster Durchlauf:
grep -R "uses:" .github/workflows
Für benutzerdefinierte Actions innerhalb des Repositories:
grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"
Diese Suchen beweisen keine Kompatibilität, liefern aber ein effizientes Inventar. Das Ziel ist, drei Fragen zu beantworten: Welche Actions werden verwendet, welche Versionen sind festgepint und welche benutzerdefinierten Actions deklarieren noch eine veraltete Runtime?
Sollten Actions an Tags oder Commit-SHAs gepinnt werden?
Eine Runtime-Migration ist auch eine gute Gelegenheit, die Supply-Chain-Hygiene zu überprüfen. Eine Referenz wie vendor/action@v4 kann von ihrem Maintainer verschoben werden, während ein voller Commit-SHA eine unveränderliche Revision identifiziert.
Für sicherheitsrelevante Workflows kann das Festpinnen von Drittanbieter-Actions an volle Commit-SHAs das Risiko unerwarteter Codeänderungen verringern. Der Kompromiss ist der Wartungsaufwand: Updates erfordern dann einen bewussten Prozess oder Abhängigkeitsaktualisierungstools.
Seien Sie besonders vorsichtig mit privilegierten Pull-Request-Workflows
Das Aktualisieren alter Actions ist wichtig, aber das Workflow-Sicherheitsmodell ist noch wichtiger. pull_request_target kann mit Zugriff auf das Token, Geheimnisse und Cache des Basis-Repositories ausgeführt werden. Das Auschecken von angreifergesteuertem Pull-Request-Code innerhalb eines solchen privilegierten Workflows kann eine ernste Schwachstelle in der Lieferkette verursachen.
Wenn Sie Workflow-Dateien auf Node 24 auditieren, überprüfen Sie gleichzeitig deren Trigger und Berechtigungen. Eine moderne Runtime macht einen unsicheren Workflow nicht sicher.
Eine praktische Migrations-Checkliste
Beginnen Sie damit, alle uses:-Verweise in .github/workflows aufzulisten. Aktualisieren Sie veraltete GitHub-eigene Actions nach dem Durchlesen der Versionshinweise. Überprüfen Sie jede Drittanbieter-Action auf eine gewartete Node-24-kompatible Version. Suchen Sie in den Metadaten benutzerdefinierter Actions nach node20, migrieren Sie es zu node24, erstellen Sie Bundles neu und testen Sie.
Überprüfen Sie bei selbst gehosteten Runnern die Runner-Version, das Betriebssystem und die Architektur. Überprüfen Sie erweiterte CodeQL-Workflows. Testen Sie abschließend wichtige Release-, Zeitplan- und Bereitstellungs-Workflows sowie den Standard-CI-Pfad, da selten genutzte Jobs oft alte Action-Versionen überdauern.
Warum sich diese Migration richtig lohnt
Node.js-Runtime-Migrationen innerhalb von GitHub Actions können wie ein Infrastrukturproblem von jemand anderem aussehen. Das sind sie nicht. Actions sind ausführbare Abhängigkeiten in Ihrem CI/CD-System. Sie können Releases erstellen, Anmeldeinformationen verwalten, Artefakte hochladen und Produktionsanwendungen bereitstellen.
GitHubs Umstieg von Node 20 auf Node 24 ist daher eine nützliche Erinnerung daran, dass CI-Abhängigkeiten Lebenszyklen haben, genau wie Anwendungsabhängigkeiten.
Die unmittelbare Aufgabe ist einfach: Entfernen Sie verbleibende Abhängigkeiten von veralteten JavaScript-Actions und aktualisieren Sie selbst gehostete Infrastruktur, wenn erforderlich. Die langfristig wertvollere Lektion ist: Betrachten Sie .github/workflows als gewartete Anwendungsinfrastruktur, nicht als Konfiguration, die einmal geschrieben und vergessen werden kann.
Ein Repository, das regelmäßig seine Actions, Runner-Versionen, Berechtigungen und Drittanbieter-Abhängigkeiten auditiert, wird für den nächsten Runtime-Wechsel wesentlich besser vorbereitet sein – und zwischen Migrationen deutlich sicherer.