Web a vývoj

GitHub Actions odstranil Node.js 20: Jak auditovat a opravit vaše workflowy

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

GitHub Actions již neumožňuje běhové prostředí Node.js 20 pro JavaScriptové akce. I když vaše aplikace nepoužívá Node.js, starý checkout, setup nebo třetí strana akce se nyní může stát problémem CI. Zde je, jak auditovat vaše workflowy, aktualizovat vlastní akce a bezpečně zkontrolovat self-hosted runners.

GitHub Actions odstranil Node.js 20. Jak zkontrolovat a opravit své pracovní postupy?

Pracovní postupy v GitHub Actions mohou záviset na Node.js, i když projekt, který sestavují, neobsahuje žádný JavaScript.

Tato skutečnost se stala důležitou.

Dne 23. září 2026 společnost GitHub dokončila odstranění Node.js 20 z runnerů GitHub Actions. JavaScriptové akce nyní běží na Node.js 24 a dočasný přepínač kompatibility, který dříve uživatelům umožňoval zůstat na Node 20, již není k dispozici.

U mnoha úložišť není třeba nic měnit. Aktuální verze vlastních akcí GitHubu již přešly na Node 24.

Starší pracovní postupy, vlastní JavaScriptové akce a někteří vlastní hostitelé běžců však vyžadují audit.

Klíčové je pochopit, jakého runtime prostředí Node.js se GitHub týká.

Runtime vašeho kódu a runtime vaší akce jsou dvě různé věci

Představme si PHP projekt s následujícím pracovním postupem:

steps:
  - uses: actions/checkout@v4

  - name: Install dependencies
    run: composer install

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

Aplikace je v PHP, ale actions/checkout je samotná JavaScriptová akce. GitHub spouští její JavaScript pomocí runtime prostředí Node.js, které je součástí runnera Actions.

Toto runtime prostředí je nezávislé na Node.js nainstalovaném vaším pracovním postupem. Stejně tak actions/setup-node může nainstalovat Node 22 pro následné příkazy pracovního postupu, zatímco samotná akce běží s runtime prostředím deklarovaným v jejích metadatech.

Tento rozdíl vysvětluje, proč odstranění Node 20 potenciálně ovlivňuje PHP, Python, Go, Java a další ne-Node projekty.

Co přesně se změnilo?

GitHub oznámil ukončení podpory Node 20 s velkým předstihem, protože Node.js 20 dosáhl konce životnosti v dubnu 2026. GitHub začal výchozí přepínání akcí na Node 24 v červnu 2026. Během migračního období mohli uživatelé dočasně vrátit zpět k zastaralému runtime pomocí ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION. To byl pouze záchranný mechanismus pro migraci.

Dne 23. září 2026 společnost GitHub odstranila Node 20 z runnerů GitHub Actions a odstranila tuto možnost odhlášení. Pokud akce, kterou udržujete, stále deklaruje Node 20, doporučuje GitHub ji aktualizovat na Node 24 a publikovat novou verzi.

První krok auditu: zkontrolujte každý řádek uses:

Nejjednodušší audit pracovního postupu začíná v .github/workflows. Hledejte uses: a inventarizujte vlastní a třetí akce. Nepředpokládejte, že pracovní postup je aktuální jen proto, že stále běží.

U každé akce určete, zda verze odkazovaná vaším pracovním postupem je aktuální verze, která podporuje Node 24. Třetí akce si zaslouží zvláštní pozornost: před změnou hlavních verzí zkontrolujte jejich historii vydání. Vstupy, výchozí hodnoty, autentizační mechanismy a chování cache se mohou měnit nezávisle na migraci Node.

Vlastní JavaScriptové akce vyžadují jinou opravu

Pokud udržujete vlastní JavaScriptovou akci, zkontrolujte její action.yml nebo action.yaml. JavaScriptová akce může stále obsahovat:

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

Deklarace runtime prostředí by měla cílit na Node 24:

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

Změna tohoto řádku je jen začátek. Testujte akci pod Node 24, aktualizujte závislosti tam, kde je to nutné, a znovu sestavte jakýkoli commitovaný dist/ bundle. Jinak mohou spotřebitelé nadále spouštět starý vygenerovaný JavaScript, i když se zdroj změnil.

Bezpečná migrace spočívá v aktualizaci vývojového prostředí, aktualizaci závislostí, změně runs.using, znovu sestavení distribuovaného JavaScriptu, spuštění testů, vyzkoušení akce v reálném pracovním postupu a poté publikování nové verze.

Samostatní běžci vyžadují zvláštní pozornost

Hosted běžci GitHubu jsou udržováni GitHubem. Samostatní běžci jsou však jiní. Aplikace běžce obsahuje spustitelné soubory Node.js, které používají JavaScriptové akce, což činí verzi běžce důležitou. Nedávné verze akcí založených na Node 24 vyžadují dostatečně nový Actions Runner.

Pokud vaše organizace provozuje vlastní běžce, zahrňte jejich verze, operační systémy a architektury do migračního auditu, místo abyste se dívali jen na pracovní postup v YAML. Staré operační systémy se mohou stát skrytou překážkou, protože Node 24 mění podporovanou platformovou základnu.

CodeQL má vlastní migrační cestu

Úložiště používající GitHub code scanning by měly zkontrolovat i svůj CodeQL pracovní postup. CodeQL Action v4 používá runtime prostředí Node.js 24. Pokročilá nastavení CodeQL by proto měla být zkontrolována na starší odkazy github/codeql-action a migrována podle aktuálních pokynů GitHubu pro kompatibilitu.

Užitečný příkaz pro audit

Na Unix-like vývojovém stroji je rychlý první průchod následující:

grep -R "uses:" .github/workflows

Pro vlastní akce uvnitř úložiště:

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

Tyto vyhledávání nedokazují kompatibilitu, ale poskytují efektivní inventarizaci. Cílem je odpovědět na tři otázky: které akce jsou použity, které verze jsou ukotveny a které vlastní akce stále deklarují zastaralé runtime prostředí?

Měly by být akce ukotveny na tagy nebo commit SHA?

Migrace runtime prostředí je také dobrou příležitostí k přezkoumání hygieny dodavatelského řetězce. Odkaz jako vendor/action@v4 může být přesunut svým správcem, zatímco plné commit SHA identifikuje neměnnou revizi.

Pro bezpečnostně citlivé pracovní postupy může ukotvení třetích akcí na plná commit SHA snížit riziko neočekávaných změn kódu. Kompromisem je údržba: aktualizace pak vyžadují záměrný proces nebo nástroje pro aktualizaci závislostí.

Buďte obzvláště opatrní u privilegovaných pracovních postupů pull-requestů

Aktualizace starých akcí je důležitá, ale bezpečnostní model pracovního postupu je ještě důležitější. pull_request_target může běžet s přístupem k tokenu, tajemstvím a cache základního úložiště. Zkontrolování kódu ovládaného útočníkem v rámci pull requestu uvnitř takového privilegovaného pracovního postupu může vytvořit vážnou zranitelnost dodavatelského řetězce.

Při auditu souborů pracovního postupu pro Node 24 zkontrolujte současně jejich spouštěče a oprávnění. Moderní runtime prostředí neudělá z nebezpečného pracovního postupu bezpečný.

Praktický kontrolní seznam migrace

Začněte tím, že uvedete všechny odkazy uses: v .github/workflows. Aktualizujte zastaralé vlastní akce po přezkoumání poznámek k vydání. Zkontrolujte každou třetí akci na udržovanou verzi kompatibilní s Node 24. Prohledejte metadata vlastní akce pro node20, migrujte ji na node24, znovu sestavte balíčky a testujte.

U vlastních běžců ověřte verzi běžce, operační systém a architekturu. Zkontrolujte pokročilé pracovní postupy CodeQL. Nakonec vyzkoušejte důležité vydávací, plánované a nasazovací pracovní postupy, stejně jako výchozí cestu CI, protože málo používané úlohy jsou místa, kde staré verze akcí často přežívají.

Proč se vyplatí provést tuto migraci správně

Migrace runtime prostředí Node.js uvnitř GitHub Actions může vypadat jako problém něčí infrastruktury někoho jiného. Ve skutečnosti to není pravda. Akce jsou spustitelné závislosti ve vašem CI/CD systému. Mohou sestavovat vydání, zpracovávat přihlašovací údaje, nahrávat artefakty a nasazovat produkční aplikace.

Přesun GitHubu z Node 20 na Node 24 je proto užitečnou připomínkou, že CI závislosti mají životní cykly stejně jako aplikace.

Okamžitý úkol je přímočarý: odstraňte zbývající závislosti na zastaralých JavaScriptových akcích a aktualizujte vlastní infrastrukturu tam, kde je to nutné. Dlouhodobější ponaučení je hodnotnější: považujte .github/workflows za udržovanou aplikační infrastrukturu, ne jako konfiguraci, která může být napsána jednou a zapomenuta.

Úložiště, které pravidelně audituje své akce, verze běžců, oprávnění a třetí závislosti, bude mnohem lépe připraveno na další přechod runtime prostředí – a bude výrazně bezpečnější mezi migracemi.