Nett og utvikling

GitHub Actions har fjernet Node.js 20: Slik kan du revidere og fikse arbeidsflytene dine

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

GitHub Actions tilbyr ikke lenger Node.js 20-runtime for JavaScript-aksjoner. Selv om applikasjonen din ikke bruker Node.js, kan en gammel checkout, setup eller tredjepartsaksjon nå bli et CI-problem. Her er hvordan du kan revidere arbeidsflytene dine, oppdatere tilpassede aksjoner og sjekke selvhostede kjørere på en trygg måte.

GitHub Actions droppet Node.js 20: Slik reviderer og fikser du arbeidsflytene dine

En GitHub Actions-arbeidsflyt kan avhenge av Node.js, selv om prosjektet den bygger ikke inneholder noe JavaScript i det hele tatt.

Denne detaljen er blitt viktig.

Den 23. september 2026 fullførte GitHub fjernelsen av Node.js 20 fra GitHub Actions-runnere. JavaScript-actions kjører nå på Node.js 24, og den midlertidige kompatibilitetsbryteren som tidligere lot brukerne bli på Node 20, er ikke lenger tilgjengelig.

For mange repositorier trenger ingenting å endre. Nåværende versjoner av GitHubs førstepartsactions har allerede byttet til Node 24.

Eldre arbeidsflyter, tilpassede JavaScript-actions og noen selvhystede runnerer bør imidlertid revideres.

Det viktige skillet er å forstå hvilken Node.js-kjøretid GitHub snakker om.

Din applikasjons kjøretid og din Action-kjøretid er to forskjellige ting

Vurder et PHP-prosjekt med denne arbeidsflyten:

steps:
  - uses: actions/checkout@v4

  - name: Install dependencies
    run: composer install

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

Applikasjonen er PHP. Men actions/checkout er i seg selv en JavaScript-action. GitHub utfører dens JavaScript ved hjelp av en Node.js-kjøretid som er pakket sammen med Actions-runneren.

Denne kjøretiden er uavhengig av Node.js som installeres av arbeidsflyten din. På samme måte kan actions/setup-node installere Node 22 for senere arbeidsflytskommandoer, mens selve actionen kjører med kjøretiden som er deklarert i metadataene dens.

Det skillet forklarer hvorfor fjernelsen av Node 20 potensielt kan påvirke PHP-, Python-, Go-, Java- og andre ikke-Node-prosjekter.

Hva endret seg nøyaktig?

GitHub kunngjorde Node 20-avviklingen godt på forhånd, siden Node.js 20 nådde slutten av livsløpet i april 2026. GitHub begynte å bytte Actions til Node 24 som standard i juni 2026. I migreringsperioden kunne brukerne midlertidig velge tilbake til den foreldrede kjøretiden med ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION. Det var bare en migreringsutvei.

Den 23. september 2026 fjernet GitHub Node 20 fra GitHub Actions-runnere og fjernet denne fravalgsmuligheten. Hvis en action du vedlikeholder fortsatt deklarerer Node 20, er GitHubs anbefaling å oppdatere den til Node 24 og publisere en ny utgivelse.

Første revisjon: inspekter hver uses:-linje

Den enkleste arbeidsflytsrevisjonen starter i .github/workflows. Søk etter uses: og opprett en oversikt over eersteparts- og tredjepartsactions. Anta ikke at en arbeidsflyt er oppdatert bare fordi den fortsatt kjører.

For hver action, avgør om versjonen som refereres til av arbeidsflyten din, er en nåværende utgivelse som støtter Node 24. Tredjepartsactions fortjener særlig oppmerksomhet: sjekk utgivelseshistorikken deres før du blint bytter hovedversjoner. Inndata, standardinnstillinger, autentiseringsmekanismer og cache-atferd kan endre seg uavhengig av Node-migrasjonen.

Tilpassede JavaScript-actions krever en annen rettelse

Hvis du vedlikeholder din egen JavaScript-action, inspekter dens action.yml eller action.yaml. En JavaScript-action kan fortsatt inneholde:

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

Kjøretidsdeklarasjonen bør rette seg mot Node 24:

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

Å endre den linjen er bare begynnelsen. Test actionen under Node 24, oppdater avhengigheter der det er nødvendig, og gjenbygg eventuelle committede dist/-bundler. Ellers kan forbrukere fortsette å kjøre generert gammel JavaScript, selv om kilden har endret seg.

En sikker migrasjon er å oppdatere utviklingsmiljøet, oppdatere avhengigheter, endre runs.using, gjenbygge den distribuerte JavaScripten, kjøre tester, utføre actionen i en ekte arbeidsflyt og deretter publisere en ny utgivelse.

Selvhystede runnerer trenger særlig oppmerksomhet

GitHub-vertede runnerer vedlikeholdes av GitHub. Selvhystede runnerer er forskjellige. Runner-applikasjonen inneholder Node.js-eksekverbare filer som brukes av JavaScript-actions, noe som gjør runner-versjonen viktig. Nye utgivelser basert på Node-24-aktioner krever en tilstrekkelig ny Actions Runner.

Hvis organisasjonen din driver selvhystede runnerer, ta med deres versjoner, operativsystemer og arkitekter i migrasjonsrevisjonen, i stedet for bare å se på arbeidsflyts-YAML. Eldre operativsystemer kan bli den skjulte blokkøren, fordi Node 24 endrer den støttede plattformgrunnlinjen.

CodeQL har sin egen migrasjonsvei

Repositorier som bruker GitHub-kodeskanning, bør også inspeksjonere sin CodeQL-arbeidsflyt. CodeQL Action v4 bruker Node.js 24-kjøretiden. Avanserte CodeQL-oppsett bør derfor sjekkes for eldre github/codeql-action-referanser og migreres i henhold til GitHubs gjeldende kompatibilitetsveiledning.

Et nyttig revisjonskommando

På en Unix-lignende utviklingsmaskin er en rask første omgang:

grep -R "uses:" .github/workflows

For tilpassede actions inne i repositoriet:

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

Disse søkene beviser ikke kompatibilitet, men de gir en effektiv oversikt. Målet er å besvare tre spørsmål: hvilke actions som brukes, hvilke versjoner som er fastlåst, og hvilke tilpassede actions som fortsatt deklarerer en foreldret kjøretid?

Bør actions fastlåses til tags eller commit-SHAer?

En kjøretidsmigrasjon er også en god anledning til å vurdere leverandørkjedehygiene. En referanse som vendor/action@v4 kan flyttes av vedlikeholdaren, mens en full commit-SHA identificerer en uforanderlig revisjon.

For sikkerhetsfølsomme arbeidsflyter kan fastlåsing av tredjepartsactions til full commit-SHAer redusere risikoen for uventede kodeendringer. Avveiningen er vedlikehold: oppdateringer krever da en bevisst prosess eller avhengighetsoppdateringsverktøy.

Vær særlig forsiktig med privilegierte pull-request-arbeidsflyter

pull_request_target kan kjøre med tilgang til basisrepositoriets token, hemmeligheter og cache. Ut-checking av angrepartrækket pull-request-kode inne i en slik privilegiert arbeidsflyt kan skape en alvorlig leverandørkjedesårbarhet.

Når du reviserer arbeidsflytsfiler for Node 24, inspekter triggere og tillatelser samtidig. En moderne kjøretid gjør ikke en usikker arbeidsflyt sikker.

En praktisk migrasjonsjekkliste

Start med å liste alle uses:-referanser i .github/workflows. Oppgrader foreldrede eerstepartsactions etter å ha lest releasenotater. Sjekk hver tredjepartsaction for en vedlikeholdt Node-24-kompatibel versjon. Søk i tilpasset action-metadata etter node20, migrer den til node24, gjenbygg bundler og test.

For selvhystede runnerer, bekreft runner-versjon, operativsystem og arkitektur. Gjennomgå avanserte CodeQL-arbeidsflyter. Til slutt, utfør viktige utgivelses-, planlagte og distribueringsarbeidsflyter samt standard CI-banen, siden sjelden brukte jobber er hvor eldre action-versjoner ofte overlever.

Hvorfor denne migrasjonen er verdt å utføre ordentlig

Node.js-kjøretidsmigrasjoner inne i GitHub Actions kan se ut som en annens infrastrukturproblem. Det er de ikke. Actions er kjørbare avhengigheter i ditt CI/CD-system. De kan bygge utgivelser, håndtere legitimasjon, laste opp artefakter og distribuere produksjonsapplikasjoner.

GitHubs flyt fra Node 20 til Node 24 er derfor en nyttig påminnelse om at CI-avhengigheter har livssykluser akkurat som applikasjonsavhengigheter.

Den umiddelbare oppgaven er enkel: fjern resterende avhengigheter til foreldrede JavaScript-actions og oppdater selvhystet infrastruktur der det er nødvendig. Den langsiktige læringen er mer verdifull: behandle .github/workflows som vedlikeholdt applikasjonsinfrastruktur, ikke konfigurasjon som kan skrives én gang og glemmes.

Et repositorier som periodisk reviderer sine actions, runner-versjoner, tillatelser og tredjepartsavhengigheter, vil være mye bedre rustet for neste kjøretidsovergang – og betraktelig tryggere mellom migrasjoner.