Web & Ontwikkeling

GitHub Actions heeft Node.js 20 verwijderd: Hoe je je workflows kunt auditen en repareren

GitHub Actions Dropped Node.js 20: How to Audit and Fix Your Workflows

GitHub Actions biedt de Node.js 20-runtime voor JavaScript-acties niet meer aan. Ook als je applicatie geen Node.js gebruikt, kan een oude checkout, setup of third‑party actie nu een CI-probleem worden. Hier lees je hoe je je workflows kunt auditen, aangepaste acties kunt bijwerken en self‑hosted runners veilig kunt controleren.

GitHub Actions Node.js 20 Verwderd: Hoe te Auditen en Repareren van je Workflows

Een GitHub Actions workflow kan afhankelijk zijn van Node.js, zelfs als het project dat hij bouwt geen JavaScript bevat.

Dat detail is belangrijk geworden.

Op 23 september 2026 heeft GitHub de verwijdering van Node.js 20 van GitHub Actions runners voltooid. JavaScript-acties draaien nu op Node.js 24, en de tijdelijke compatibiliteitsschakelaar die gebruikers in staat stelde om op Node 20 te blijven, is niet meer beschikbaar.

Voor veel repositories hoeft niets te veranderen. Huidige versies van GitHub's eigen acties zijn al overgestapt op Node 24.

Oudere workflows, aangepaste JavaScript-acties en sommige self-hosted runners verdienen echter een audit.

Het belangrijke onderscheid is het begrijpen welke Node.js-runtime GitHub bedoelt.

Jouw toepassingsruntime en jouw Actie-runtime zijn twee verschillende dingen

Overweeg een PHP-project met deze workflow:

steps:
  - uses: actions/checkout@v4

  - name: Install dependencies
    run: composer install

  - name: Run tests
    run: vendor/bin/phpunit

De toepassing is PHP. Maar actions/checkout is zelf een JavaScript-actie. GitHub voert zijn JavaScript uit met een Node.js-runtime die wordt meegeleverd met de Actions-runner.

Die runtime is onafhankelijk van de Node.js die door je workflow wordt geïnstalleerd. Daarnaast kan actions/setup-node Node 22 installeren voor latere workflow-opdrachten terwijl de actie zelf wordt uitgevoerd met de runtime die in zijn metadata is gedeclareerd.

Dat onderscheid verklaart waarom het verwijderen van Node 20 potentieel PHP, Python, Go, Java en andere niet-Node-projecten kan beïnvloeden.

Wat is er precies veranderd?

Git kondigde de obsolescentie van Node 20 ruim van tevoren aan, omdat Node.js 20 aan het einde van zijn levensduur kwam in april 2026. Git begon in juni 2026 standaard acties over te schakelen naar Node 24. Tijdens de migratieperiode konden gebruikers tijdelijk terug schakelen naar de verouderde runtime met ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION. Dat was slechts een migratie-uitweg.

Op 23 september 2026 heeft GitHub Node 20 van GitHub Actions runners verwijderd en die optie uitgehaald. Als een actie die je onderhoudt nog steeds Node 20 declareert, is de aanbeveling van GitHub deze te updaten naar Node 24 en een nieuwe release te publiceren.

Eerste audit: inspecteer elke uses: regel

De simpelste workflow-audit begint in .github/workflows. Zoek naar uses: en maak een inventory van eerste-partij en derden-acties. Stel niet dat een workflow current is slechts omdat hij nog steeds draait.

Voor elke actie, bepaal of door je workflow verwezenste versie een huidige release is die Node 24 ondersteunt. Derden-acties verdienen bijzondere aandacht: controleer hun releasegeschiedenis voordat je major-versies blindwijzigigt. Ingangen, standaardwaarden, authenticatiemechanismen en cachegedrag kunnen onafhankelijk van de Node-migratie veranderen.

Aangepaste JavaScript-acties vereisen een andere fix

Als u uw eigen JavaScript-actie onderhoudt, inspektorneer zijn action.yml of action.yaml. Een JavaScript-actie kan nog steeds bevatten:

runs:
  using: node20
  main: dist/index.js

De runtime-aanname moet Node 24:

runs:
  using: node24
  main: dist/index.js

Het wijzigen van die regel is slechts het begin. Test de actie onder Node 24, werk bij verzo erforder dependencies bij en herbouw eventueel gecommitteerde dist/ bundel. Anders kunnen consumenten nog steeds oude gegenereerde JavaScript uitvoeren, zelfsal is de bron gewijzigd.

Een veilige migratie houdt in om de ontwikkelomgeving bij te werken, afhankelijkheden bij te werken, runs.using te wijzigen, de gedistribueerde JavaScript te herbouwen, tests uit te voeren, de actie in een echte workflow te oefenen en vervolgens een nieuwe release te publiceren.

Self-hosted runners hebben speciale aandacht nodig

GitHub-gehoste runners worden beheerd door GitHub. Self-hosted runners zijn anders. De runner-toepassing bevat de Node.js-executables die worden gebruikt door JavaScript-acties, waardoor de runner-versie belangrijk is.

Recente Node-24-gebaseerde actie-releases vereisen een recent genoeg Actions Runner.

Als uw organisatie self-hosted runners bedient, voer dan hun versies, besturingssystemen en architecturen op in de migratie-audit in plaats van alleen naar workflow YAML te kijken. Oude besturingssystemen kunnen de verborgen blokker worden, omdat Node 24 de ondersteunde platformbasislijn verandert.

CodeQL heeft zijn eigen migratiepad

Repositories die GitHub code scanning gebruiken, moeten hun CodeQL-workflow ook inspecteren. CodeQL Action v4 gebruikt de Node.js 24 runtime. Geavanceerde CodeQL-setups moeten daarom worden gecontroleerd op oudere github/codeql-action referenties en gemigreerd volgens GitHub's huidige compatibiliteitsrichtlijnen.

Een nuttige audit-opdracht

Op een Unix-achtige ontwikkelmachine, een snelle eerste doorloop is:

grep -R "uses:" .github/workflows

Voor aangepaste acties binnen de repository:

grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"

Deze zoekacties bewijzen geen compatibiliteit, maar bieden een efficiënte inventory. Het doel is om drie vragen te beantwoorden: welke acties worden gebruikt, welke versies zijn vastgeplakt, en welke aangepaste acties declareren nog een verouderde runtime?

Moeten acties worden vastgeplakt aan tags of commit SHAs?

Een runtime-migratie is ook een goed moment om supply-chain hygiëne te controleren. Een referentie als vendor/action@v4 kan worden verplaatst door zijn maintainer, terwijl een volledige commit-SHA een onveranderlijke revisie identificeert.

Voor beveiliging-sensitive workflows kan het vastplakken van derden-acties aan volledige commit SHAs het risico op onverwachte code-wijzigingen reduceren. De trade-off is onderhoud: updates vereisen dan een proces of dependency-update tooling.

Wees extra voorzichtig met bevoegde pull-request workflows

Het updaten van oude acties is belangrijk, maar het workflow-beveiligingsmodel telt zelfs meer. pull_request_target kan worden uitgevoerd met toegang tot de basis-repository's token, secrets en cache. Het uitchecken van aanvaller-gedraaid pull-request code binnen een dergelijk bevoegde workflow kan een serieuze supply-chain kwetsbaarheid creëren.

Bij het auditeren van workflow-bestanden op Node 24, inspecteer hun triggers en machtigingen tegelijkertijd. Een moderne runtime maakt een onveilige workflow niet veiliger.

Een praktische migratie checklist

Begin met alle uses:-verwijzingen in .github/workflows op te lijsten. Upgrade verouderde eerste-partij acties na het doorlezen van release-opmerkingen. Controleer elke derden-actie op een onderhouden Node-24-compatible versie. Zoek custom actie metadata naar node20, migreer deze naar node24, herbouw bundles en test.

Voor self-hosted runners, verifieer runner-versie, besturingssysteem en architectuur. Review CodeQL geavanceerde workflows. Ten slotte, exerciseer belangrijke release-, geplande en deployments-workflows evenals de standaard CI-pad, omdat zelden gebruikte banen vaak oude actie-versies overleven.

Waarom deze migratie het waard is om goed te doen

Node.js runtime-migraties binnen GitHub Actions kunnen eruit zien als iemand anders' infrastructuur-probleem. Dat zijn ze niet. Acties are executable dependencies in your CI/CD system. Ze kunnen releases bouwen, referenties afhandelen, artifacts uploaden en productie-applicaties implementeren.

GitHub's verplaatsing van Node 20 naar Node 24 is daarom een nuttige herinnering dat CI-afhankelijkheden lifecycles hebben, net als toepassingsafhankelijkheden.

De directe taak is eenvoudig: verwijder overblijfselen van verouderde JavaScript-acties en update self-hosted infrastructuur waar nodig. De langere termijn les is waardevoller: behandle .github/workflows als onderhouden applicatie-infrastructuur, niet als configuratie die eens kan worden geschreven en vergeten.

Een repository dat periodiek zijn acties, runner-versies, machtigingen en derden-afhankelijkheden auditeert, zal veel beter voorbereid zijn op de volgende runtime-overgang—ander aanzienlijk veiliger tussen migraties.