GitHub Actions on poistanut Node.js 20:n: Kuinka tarkistaa ja korjata työnkulkujesi
GitHub Actions ei enää tarjoa Node.js 20 -aikoympäristöä JavaScript-toimintojen (actions) käyttöön. Vaikka sovelluksesi ei käytä Node.js:ää, vanha checkout-, setup- tai kolmannen osapuolen action voi nyt aiheuttaa CI-ongelman. Tässä on, miten voit tarkistaa työnkulkujesi, päivittää räätälöidyt actionit ja tarkistaa itse isännöidyt runnerit turvallisesti.
GitHub Actions hylkäsi Node.js 20: Kuinka tarkistaa ja korjata työnkulut
A GitHub Actions workflow can depend on Node.js even when the project it builds contains no JavaScript at all.
GitHub Actions -työnkulku voi riippua Node.js:stä, vaikka sen rakentamassa projektissa ei olisi lainkaan JavaScriptiä.
That detail has become important.
Tämä yksityiskohta on tullut tärkeäksi.
On September 23, 2026, GitHub completed the removal of Node.js 20 from GitHub Actions runners. JavaScript actions now run on Node.js 24, and the temporary compatibility switch that previously allowed users to remain on Node 20 is no longer available.
- syyskuuta 2026 GitHub sai valmiiksi Node.js 20:n poistamisen GitHub Actions -ajureista. JavaScript-toiminnot käyttävät nyt Node.js 24:ää, eikä tilapäinen yhteensopivuuskytkin, joka aiemmin salli käyttäjien jatkaa Node 20:lla, ole enää käytettävissä.
For many repositories, nothing needs to change. Current versions of GitHub's first-party actions have already moved to Node 24.
Monissa repositorioissa mitään ei tarvitse muuttaa. GitHubin omien toimintojen nykyaikaiset versiot ovat jo siirtyneet Node 24:ään.
Older workflows, custom JavaScript actions and some self-hosted runners deserve an audit, however.
Vanhoja työnkulkuja, mukautettuja JavaScript-toimintoja ja joitakin itse isännöityjä ajureita on kuitenkin tarkastettava.
The important distinction is understanding which Node.js runtime GitHub is talking about.
Tärkeä ero on ymmärtää, mistä Node.js -suoritusympäristöstä GitHub puhuu.
Your application runtime and your Action runtime are different things
Sovelluksesi suoritusympäristö ja Toimintosi suoritusympäristö ovat eri asioita
Consider a PHP project with this workflow:
Harkitse PHP-projektia, jolla on tämä työnkulku:
steps:
- uses: actions/checkout@v4
- name: Install dependencies
run: composer install
- name: Run tests
run: vendor/bin/phpunit
steps:
- uses: actions/checkout@v4
- name: Install dependencies
run: composer install
- name: Run tests
run: vendor/bin/phpunit
The application is PHP. But actions/checkout is itself a JavaScript action. GitHub executes its JavaScript using a Node.js runtime bundled with the Actions runner.
Sovellus on PHP. Mutta actions/checkout on itse JavaScript-toiminto. GitHub suorittaa sen JavaScriptin käyttäen Actions-ajurin mukana toimitettua Node.js -suoritusympäristöä.
That runtime is independent from Node.js installed by your workflow. Likewise, actions/setup-node can install Node 22 for subsequent workflow commands while the action itself executes with the runtime declared in its metadata.
Tämä suoritusympäristö on riippumaton työnkulun asentamasta Node.js:stä. Vastaavasti actions/setup-node voi asentaa Node 22:n myöhempiä työnkulun komentoja varten, kun toiminto itse suoritetaan sen metatiedoissa ilmoitetulla suoritusympäristöllä.
That distinction explains why the Node 20 removal potentially affects PHP, Python, Go, Java and other non-Node projects.
Tämä ero selittää, miksi Node 20:n poistaminen voi mahdollisesti vaikuttaa PHP-, Python-, Go-, Java- ja muihin ei-Node-projekteihin.
What exactly changed?
Mitä tarkalleen ottaen muuttui?
GitHub announced the Node 20 deprecation well in advance because Node.js 20 reached end of life in April 2026. GitHub began switching Actions to Node 24 by default in June 2026. During the migration period, users could temporarily opt back into the obsolete runtime with ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION. That was only a migration escape hatch.
GitHub ilmoitti Node 20:n vanhentumisesta hyvissä ajoin etukäteen, koska Node.js 20:n elinkaari päättyi huhtikuussa 2026. GitHub alkoi vaihtaa Toiminnot oletusarvoisesti Node 24:ään kesäkuussa 2026. Siirtymäjakson aikana käyttäjät pystyivät tilapäisesti ottamaan uudelleen käyttöön vanhentuneen suoritusympäristön ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION:llä. Se oli vain siirtymän poistumistie.
On September 23, 2026, GitHub removed Node 20 from GitHub Actions runners and removed that opt-out. If an action you maintain still declares Node 20, GitHub's recommendation is to update it to Node 24 and publish a new release.
- syyskuuta 2026 GitHub poisti Node 20:n GitHub Actions -ajureista ja poisti kyseisen opt-outin. Jos ylläpitämäsi toiminto ilmoittaa edelleen Node 20:ksi, GitHub suosittelee päivittämään sen Node 24:ään ja julkaisemaan uuden version.
First audit: inspect every uses: line
Ensimmäinen tarkastus: tarkista jokainen uses: -rivi
The simplest workflow audit starts in .github/workflows. Search for uses: and inventory first-party and third-party actions. Do not assume that a workflow is current merely because it still runs.
Yksinkertaisin työnkulun tarkastus alkaa .github/workflows:stä. Etsi uses: ja luettele omat ja kolmannen osapuolen toiminnot. Älä olettaa, että työnkulku on ajan tasalla vain siksi, että se toimii edelleen.
For each action, determine whether the version referenced by your workflow is a current release that supports Node 24. Third-party actions deserve particular attention: check their release history before changing major versions blindly. Inputs, defaults, authentication mechanisms and cache behavior can change independently of the Node migration.
Kullekin toiminnolle määritä, onko työnkulun viittaama versio nykyaikainen julkaisu, joka tukee Node 24:ää. Kolmannen osapuolen toiminnot ansaitsevat erityistä huomiota: tarkista niiden julkaisuhistoria ennen suuren version muutoksen tekemistä sokeasti. Syötteet, oletusarvot, todentamismekanismit ja välimuistin käyttäytyminen voivat muuttua itsenäisesti Node-siirtymästä.
Custom JavaScript actions require a different fix
Mukautetut JavaScript-toiminnot vaativat erilaista korjausta
If you maintain your own JavaScript action, inspect its action.yml or action.yaml. A JavaScript action may still contain:
Jos ylläpitää omaa JavaScript-toimintoa, tarkista sen action.yml tai action.yaml. JavaScript-toiminto voi vielä sisältää:
runs:
using: node20
main: dist/index.js
runs:
using: node20
main: dist/index.js
The runtime declaration should target Node 24:
Suoritusympäristöilmoituksen tulisi kohdistua Node 24:ään:
runs:
using: node24
main: dist/index.js
runs:
using: node24
main: dist/index.js
Changing that line is only the beginning. Test the action under Node 24, update dependencies where required and rebuild any committed dist/ bundle. Otherwise consumers may continue executing old generated JavaScript even though the source has changed.
Sen rivin muuttaminen on vain alku. Testaa toiminto Node 24:n alla, päivitä riippuvuudet tarvittaessa ja uudelleenrakenna kaikki talletetut dist/ -paketit. Muussa tapauksessa kuluttajat voivat jatkaa vanhan luodun JavaScriptin suorittamista, vaikka lähde on muuttunut.
A safe migration is to update the development environment, update dependencies, change runs.using, rebuild the distributed JavaScript, run tests, exercise the action in a real workflow and then publish a new release.
Turvallinen siirtymä on päivittää kehitysympäristö, päivittää riippuvuudet, muuttaa runs.using, uudelleenrakentaa jaettu JavaScript, suorittaa testit, käyttää toimintoa todellisessa työnkulussa ja julkaista sitten uusi julkaisu.
Self-hosted runners need special attention
Itse isännöidyt ajurit vaativat erityistä huomiota
GitHub-hosted runners are maintained by GitHub. Self-hosted runners are different. The runner application contains the Node.js executables used by JavaScript actions, making the runner version important. Recent Node-24-based action releases require a sufficiently recent Actions Runner.
GitHub-isännöidyt ajurit ylläpitää GitHub. Itse isännöidyt ajurit ovat eri asia. Ajurisovellus sisältää JavaScript-toimintojen käyttämät Node.js -suoritettavat tiedostot, mikä tekee ajurin versiosta tärkeän. Uudemmat Node 24 -pohjaiset toimintoversiot edellyttävät riittävän uutta Actions Runner -ohjelmistoa.
If your organization operates self-hosted runners, include their versions, operating systems and architectures in the migration audit rather than looking only at workflow YAML. Old operating systems can become the hidden blocker because Node 24 changes the supported platform baseline.
Jos organisaatiosi käyttää itse isännöityjä ajureita, sisällytä niiden versiot, käyttöjärjestelmät ja arkkitehtuurit siirtymätarkastukseen sen sijaan, että tarkastelisit vain työnkulun YAML-tiedostoa. Vanhat käyttöjärjestelmät voivat olla piilevä este, koska Node 24 muuttaa tuetun alustan perusvaatimuksen.
CodeQL has its own migration path
CodeQL:lla on oma siirtymäpolkunsa
Repositories using GitHub code scanning should inspect their CodeQL workflow too. CodeQL Action v4 uses the Node.js 24 runtime. Advanced CodeQL setups should therefore be checked for older github/codeql-action references and migrated according to GitHub's current compatibility guidance.
GitHubin koodiskannausta käyttävien repositorioiden tulisi tarkistaa myös CodeQL-työnkulku. CodeQL Action v4 käyttää Node.js 24 -suoritusympäristöä. Edistyneet CodeQL-asetukset tulisi siksi tarkistaa vanhempien github/codeql-action -viittausten varalta ja siirtää Githanin nykyisten yhteensopivuusohjeiden mukaisesti.
A useful audit command
Hyödyllinen tarkastuskomento
On a Unix-like development machine, a quick first pass is:
Unix-tyyppisessä kehityskoneessa nopea ensimmäinen kierros on:
grep -R "uses:" .github/workflows
grep -R "uses:" .github/workflows
For custom actions inside the repository:
Repositorion sisäisille mukautetuille toiminnoille:
grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"
grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"
These searches do not prove compatibility, but they provide an efficient inventory. The goal is to answer three questions: which actions are used, which versions are pinned, and which custom actions still declare an obsolete runtime?
Nämä haut eivät todista yhteensopivuutta, mutta ne tarjoavat tehokkaan inventaarion. Tavoitteena on vastata kolmeen kysymykseen: mitä toimintoja käytetään, mitä versioita on kiinnitetty ja mitkä mukautetut toiminnot ilmoittavat edelleen vanhentuneesta suoritusympäristöstä?
Should actions be pinned to tags or commit SHAs?
Pitäisikö toiminnot kiinnittää tageihin vai commit-SHA-tunnuksiin?
A runtime migration is also a good opportunity to review supply-chain hygiene. A reference such as vendor/action@v4 can be moved by its maintainer, while a full commit SHA identifies an immutable revision.
Suoritusympäristön siirtymä on myös hyvä tilaisuus tarkistaa toimitusketjun hygienia. Viite, kuten vendor/action@v4, voidaan siirtää sen ylläpitäjän toimesta, kun taas täydellinen commit-SHA tunnistaa muuttumattoman revisiota.
For security-sensitive workflows, pinning third-party actions to full commit SHAs can reduce the risk of unexpected code changes. The trade-off is maintenance: updates then require a deliberate process or dependency-update tooling.
Turvakriittisissä työnkuluissa kolmannen osapuolen toimintojen kiinnittäminen täydellisiin commit-SHA-tunnuksiin voi vähentää odottamattomien koodimuutosten riskiä. Kompromissi on ylläpito: päivitykset vaativat sitten harkitun prosessin tai riippuvuuspäivitystyökalut.
Be especially careful with privileged pull-request workflows
Ole erityisen varovainen etuoikeutettujen pull request -työnkulkujen kanssa
Updating old actions is important, but the workflow security model matters even more. pull_request_target can run with access to the base repository's token, secrets and cache. Checking out attacker-controlled pull-request code inside such a privileged workflow can create a serious supply-chain vulnerability.
Vanhojen toimintojen päivittäminen on tärkeää, mutta työnkulun turvallisuusmalli on vielä tärkeämpi. pull_request_target voi suorittaa pääsyllä perustiedoston tunnukseen, salaisuuksiin ja välimuistiin. Hyökkääjän hallitseman pull request -koodin ulostaminen tällaisessa etuoikeutetussa työnkulussa voi luoda vakavan toimitusketjun haavoittuvuuden.
When auditing workflow files for Node 24, inspect their triggers and permissions at the same time. A modern runtime does not make an unsafe workflow secure.
Tarkista työnkulkujen käynnistimet ja käyttöoikeudet samalla kun tarkistat työnkulkuja Node 24:ää varten. Nykyaikainen suoritusympäristö ei tee turvattomasta työnkulusta turvallista.
A practical migration checklist
Käytännöllinen siirtymätarkistuslista
Start by listing all uses: references in .github/workflows. Upgrade obsolete first-party actions after reviewing release notes. Check every third-party action for a maintained Node-24-compatible version. Search custom action metadata for node20, migrate it to node24, rebuild bundles and test.
Aloita listaamalla kaikki uses: -viittaukset .github/workflows:issä. Päivitä vanhentuneet omat toiminnot tutkittuasi julkaisutiedot. Tarkista jokainen kolmannen osapuolen toiminto ylläpidetyn Node-24-yhteensopivan version osalta. Etsi mukautettujen toimintojen metatiedoista node20, siirrä se muotoon node24, uudelleenrakenna paketit ja testaa.
For self-hosted runners, verify runner version, operating system and architecture. Review CodeQL advanced workflows. Finally, exercise important release, scheduled and deployment workflows as well as the default CI path, because rarely used jobs are where old action versions often survive.
Itse isännöidyille ajureille tarkista ajurin versio, käyttöjärjestelmä ja arkkitehtuuri. Tarkista CodeQL:n edistyneet työnkulut. Lopuksi testaa tärkeitä julkaisu-, ajastettuja ja käyttöönotto-työnkulkuja sekä oletus-CI-polku, koska harvoin käytetyt työt ovat paikkoja, joissa vanhat toimintoversiot usein säilyvät.
Why this migration is worth doing properly
Miksi tämä siirtymä kannattaa tehdä kunnolla
Node.js runtime migrations inside GitHub Actions can look like somebody else's infrastructure problem. They are not. Actions are executable dependencies in your CI/CD system. They can build releases, handle credentials, upload artifacts and deploy production applications.
Node.js -suoritusympäristön siirtymät GitHub Actionsin sisällä voivat näyttää jonkun muun infrastruktuuriongelmalta. Ne eivät ole. Toiminnot ovat suoritettavia riippuvuuksia CI/CD-järjestelmässäsi. Ne voivat rakentaa julkaisuja, käsitellä tunnistetietoja, ladata artefakteja ja ottaa käyttöön tuotantosovelluksia.
GitHub's move from Node 20 to Node 24 is therefore a useful reminder that CI dependencies have lifecycles just like application dependencies.
Siksi Githanin siirtymä Node 20:sta Node 24:ään on hyödyllinen muistutus siitä, että CI-riippuvuuksilla on elinkaaret aivan kuten sovellusriippuvuuksillakin.
The immediate task is straightforward: remove remaining dependencies on obsolete JavaScript actions and update self-hosted infrastructure where necessary. The longer-term lesson is more valuable: treat .github/workflows as maintained application infrastructure, not configuration that can be written once and forgotten.
Välitön tehtävä on yksinkertainen: poista jäljellä olevat riippuvuudet vanhentuneista JavaScript-toiminnoista ja päivitä itse isännöity infrastruktuuri tarvittaessa. Pitkäaikainen opetus on arvokkaampi: käsittele .github/workflows ylläpidetynä sovelluksen infrastruktuurina, älä määrityksenä, jota voidaan kirjoittaa kerran ja unohtaa.
A repository that periodically audits its actions, runner versions, permissions and third-party dependencies will be much better prepared for the next runtime transition—and considerably safer between migrations.
Repositorio, joka tarkistaa säännöllisesti toimintonsa, ajuriversionsa, käyttöoikeutensa ja kolmannen osapuolen riippuvuutensa, on paljon paremmin valmistautunut seuraavaan suoritusympäristön siirtymään—ja huomattavasti turvallisempi siirtymien välillä.