Web & Udvikling

GitHub Actions har fjernet Node.js 20: Sådan gennemgår og retter du dine workflows

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

GitHub Actions leverer ikke længere Node.js 20-runtime for JavaScript-actions. Selv hvis din applikation ikke bruger Node.js, kan en gammel checkout, setup eller tredjepartsaction nu blive et CI-problem. Her er, hvordan du kan gennemgå dine workflows, opdatere brugerdefinerede actions og tjekke selvhostede runners sikkert.

GitHub Actions har fjernet Node.js 20: Sådan auditorer og retter du dine workflows

En GitHub Actions-workflow kan afhænge af Node.js selv når projektet, der byges, iøvrigt ikke indeholder nogen JavaScript.

Dette detalj er blevet vigtigt.

Den 23. september 2026 fuldførte GitHub fjernelsen af Node.js 20 fra GitHub Actions-runners. JavaScript-actions kører nu på Node.js 24, og den midlertidige kompatibilitetsvend, som tidligere tillod brugere at forblive på Node 20, er ikke længere tilgængelig.

For mange repositorier kræves der ingen ændringer. Nuværende versioner af GitHubs første-partss-api'er har allerede flyttet til Node 24.

Ældre workflows, brugerdefindede JavaScript-actions og nogle selvværtte runners har dog brug for en audit.

Det vigtige distinkt er at forstå hvilket Node.js-kørselstid GitHub taler om.

Din applikationskørselstid og din Action-kørselstid er forskellige ting

Overvej et PHP-projekt med denne workflow:

steps:
  - uses: actions/checkout@v4

  - name: Install dependencies
    run: composer install

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

Applikationen er PHP. Men actions/checkout er selv en JavaScript-action. GitHub udfører dens JavaScript ved hjælp af et Node.js-kørselstid, der er indesmitht i Actions-runneren.

Dette kørselstid er uafhængigt af Node.js, der er installeret af din workflow. Likewise kan actions/setup-node installere Node 22 til efterfølgende workflow-kommandoer, mens selectionen selv udføres med kørselstid, der er deklareret i dens metadata.

Dette distinkt forklarer, hvorfor Node 20-fjernelsen potentielt påvirker PHP, Python, Go, Java og andre ikke-Node-projekter.

Hvad præcis har ændret sig?

GitHub annoncerede Node 20-udgaafen godt i forvejen, fordi Node.js 20 nåede slutliv i april 2026. GitHub begyndte at skifte Actions til Node 24 som standard i juni 2026. Under den migreringsperiode kunne brugere midlertidigt vælge at slippe tilbage til den forudløbne kørselstid med ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION. Det var kun en migrations-evakkeringsdør.

Den 23. september 2026 fjernede GitHub Node 20 fra GitHub Actions-runners og fjernede denne uddybning. Hvis en action, du vedligeholderer, stadig deklarerer Node 20, anbefaler GitHub at opdatere den til Node 24 og udgive en ny udgave.

Første audit: inspicér hver uses:-linje

Den enkleste workflow-audit starter i .github/workflows. Søg efter uses: og inventory første-part- og tredjepart-actions. Anmod ikke om, at en workflow er opdateret, bare fordi den stadig kører.

For hver action skal du bestemme, om den version, der er refereret af din workflow, er en nuværende udgave, der understøtter Node 24. Tredjepart-actions har særlig omtanke: tjek dem før du ændrer i væsentlige versioner. Indstillinger, standardværdier, godkendelsesmekanismer og cachetype kan ændre sig uafhængigt af Node-migrationen.

Brugerdefinede JavaScript-actions kræver en anden løsning

Hvis du vedligeholderer din egen JavaScript-action, skal du inspicere dens action.yml eller action.yaml. En JavaScript-action kan stadig indeholde:

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

Kørselstidsdeklarationen bør målrette Node 24:

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

At ændre denne linje er kun begyndelsen. Test actionen under Node 24, opdatér afhængigheder, hvor det kræves, og genbygg eventuelle committed dist/-bundle. Ellers kan forbrugere fortsat udføre old genereret JavaScript, selvom kildekoden er ændret.

En sikkert migreringsforløb er at opdatere udviklingsmiljøet, opdatere afhængigheder, ændre runs.using, genbygde distribueret JavaScript, kør teste, øv actionen i en rigtig workflow og udgivelse en ny udgave.

Selvværtte runners har særlig omtanke

GitHub-værtte runners vedligeholdes af GitHub. Selvværtte runners er forskellige. Runner-applikationen indeholder Node.js-eksikver for JavaScript-actions, hvilket gør runner-version vigtig. Recent Node-24-baserede action-udgaver kræver en tilstrækkeligt ny Actions Runner.

Hvis din organisation opererer selvværtte runners, skal du inkludere deres versioner, operativsystemer og arkitekturer i migrationsaudit i stedet for at kigge kun på workflow-YAML. Gamle operativsystemer kan blive en skjult blocker, fordi Node 24 ændre det støttede platformgrundlag.

CodeQL har sin egen migreringsvej

Repositorier, der bruger GitHub kodeindtastning, skal også inspicere deres CodeQL-workflow. CodeQL Action v4 bruger Node.js 24-kørselstid. Avancerede CodeQL-opstillingen bør derfor tjekkes efter ældre github/codeql-action-referencer og migreres ifølGgithubs nuværende kompatibilitetsvejledning.

Et nyttigt auditkommando

På en Unix-lignende udviklingsmaskine kan en hurtig første gennemgang være:

grep -R "uses:" .github/workflows

For brugerdefindede actions i repositoriet:

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

Disse søgninger beweger ikke kompatibilitet, men giver en effektiv inventering. Målet er at svare på tre spørgsmål: hvilke actions er brugt, hvilke versioner er fastsat, og hvilke brugerdefinede actions deklarerer stadig et forældet kørselstid?

Skal actions fastspændes til tags eller commit-SHAs?

En runtime-migration er også en god mulighed for at gennemgå supply-kæde-hygién. En reference som vendor/action@v4 kan bevæges af dens vedligeholdende, mens en fuld commit-SHA identificerer en umutabel revision.

For sikkerhedskritiske workflows kan fastspænding af tredjepart-actions til fulde commit-SHAs reducere risikoen for uventede kodeændringer. Omstiien er vedligeholdelse: opdateringer kræver derefter en bevidst proces eller afhængigheds-opdateringsværktøjer.

Vær især opmærkssom med privilecerede pull-request-workflows

At opdatere gamle actions er vigtigt, men workflow-sikkerhedsmodellen er endnu vigtigere. pull_request_target kan køre med adgang til base-repositoriets token, hemmeligheder og cach. Att udløse angribers-kontrollieret pull-request-kode indenfor en sådan privilegeret workflow kan skabe en alvorlig supply-kæde-sårbarhed.

Når du auditorer workflow-filer for Node 24, skal du samtidig inspicere deres udløsende og væligstillinger. En moderne runtime gør ikke en usikkert workflow sikkert.

En praktisk migrationskontrolliste

Start ved at liste alle uses:-referencer i .github/workflows. Opdatér forældede første-part-actions efter at have gennemgået udgaveliste. Tjek hver tredjepart-action for en vedligeholdt Node-24-kompatibel version. Søg brugerdefinerede actions-metadata efter node20, migrer den til node24, genbyg bundles og test.

For selvværtte runners, verificér runner-version, operativsystem og arkitektur. Gennemgå avancerede CodeQL-workflows. Endelig, udfør vigtige release, planlagte og deployment-workflows samt den standard-CI-væje, fordi sjældent brugte jobs er sted hvor gamle action-versioner ofte overlevelse.

Hvorfor denne migration er værd at gøre ordentligt

Node.js-runtime-migrationer inden for GitHub Actions kan få en til at syne som en andens infrastruktur-problematik. De er ikke. Actions er eksekverbare afhængigheder i dit CI/CD-system. De kan bygge releases, håndtere legitimationsoplysninger, uploade artefakter og udrulle produktionsapplikationer.

GitHubs bevægelse fra Node 20 til Node 24 er derfor et nyttigt påmindelse om, at CI-afhængigheder har livscyclaer lige så som applikationsafhængigheder.

Opgaven i øjeblikket er simpel: fjern resterende afhængigheder af forældede JavaScript-actions og opdatér selvværtte infrastruktur, hvor det kræves. Længere-terminale lektionen er mere værd: behandl .github/workflows som vedligeholdt applikationsinfrastruktur, ikke som konfiguration, der kan skrives éne gang og glemes.

Et repositori, der periodisk auditorer sine actions, runner-versioner, væligstillinger og tredjepart-afhængigheder, vil være langt bedre rustet til den næste runtime-overgang — og betydeligt sikkert mellem migrationer.