GitHub Actions usunął Node.js 20: Jak audytować i naprawić swoje przepływy pracy
GitHub Actions już nie udostępnia środowiska Node.js 20 dla akcji JavaScript. Nawet jeśli Twoja aplikacja nie korzysta z Node.js, stara akcja checkout, setup lub zewnętrzna akcja może teraz stać się problemem CI. Oto jak audytować swoje przepływy pracy, aktualizować własne akcje i bezpiecznie sprawdzić samodzielne runnery.
GitHub Actions porzuciło Node.js 20: Jak zaudytować i naprawić swoje workflow
Workflow GitHub Actions może zależeć od Node.js nawet wtedy, gdy projekt, który buduje, nie zawiera wcale kodu JavaScript.
Ten szczegół stał się ważny.
23 września 2026 roku GitHub ukończyło usuwanie Node.js 20 z runnerów GitHub Actions. Akcje JavaScript uruchamiane są teraz na Node.js 24, a tymczasowy przełącznik kompatybilności, który wcześniej pozwalał użytkownikom pozostać na Node 20, nie jest już dostępny.
W przypadku wielu repozytoriów nic nie musi się zmieniać. Aktualne wersje oficjalnych akcji GitHub zostały już zmigrowane na Node 24.
Starsze workflow, niestandardowe akcje JavaScript oraz niektóre samohostowane runnery zasługują na audyt, jednakże.
Kluczowe rozróżnienie polega na zrozumieniu o którym środowisku uruchomieniowym Node.js mówi GitHub.
Środowisko uruchomieniowe Twojej aplikacji i środowisko uruchomieniowe Twojej Akcji to różne rzeczy
Rozważmy projekt PHP z tym workflow:
steps:
- uses: actions/checkout@v4
- name: Install dependencies
run: composer install
- name: Run tests
run: vendor/bin/phpunit
Aplikacja jest napisana w PHP. Ale actions/checkout jest samą w sobie akcją JavaScript. GitHub wykonuje jej kod JavaScript, używając środowiska uruchomieniowego Node.js dołączonego do runnera Actions.
To środowisko jest niezależne od Node.js zainstalowanego przez Twój workflow. Podobnie, actions/setup-node może zainstalować Node 22 do użytku w kolejnych poleceniach workflow, podczas gdy sama akcja wykonuje się z środowiskiem zadeklarowanym w swoich metadanych.
To rozróżnienie wyjaśnia, dlaczego usunięcie Node 20 potencjalnie wpływa na projekty PHP, Python, Go, Java i inne projekty niebędące Node.
Co dokładnie się zmieniło?
GitHub ogłosiło przestarzałość Node 20 z wyprzedzeniem, ponieważ Node.js 20 osiągnął koniec cyklu życia w kwietniu 2026 roku. GitHub rozpoczęło przełączanie Actions na Node 24 domyślnie w czerwcu 2026 roku. W okresie migracji użytkownicy mogli tymczasowo wrócić do przestarzałego środowiska za pomocą ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION. Był to jedynie awaryjny wyjście migracyjne.
23 września 2026 roku GitHub usunęło Node 20 z runnerów GitHub Actions i usunęło to wyjście. Jeśli akcja, którą utrzymujesz, wciąż deklaruje Node 20, zalecenie GitHub polega na zaktualizowaniu jej do Node 24 i opublikowaniu nowej wersji.
Pierwszy audyt: sprawdź każdą linię uses:
Najprostszy audyt workflow zaczyna się w .github/workflows. Szukaj uses: i spisuj oficjalne i third-party akcje. Nie zakładaj, że workflow jest aktualne tylko dlatego, że wciąż działa.
Dla każdej akcji ustal, czy wersja referencyjna w Twoim workflow to aktualne wydanie obsługujące Node 24. Third-party akcje zasługują na szczególną uwagę: sprawdź ich historię wydań przed ślepą zmianą wersji major. Wejścia, wartości domyślne, mechanizmy autentykacji i zachowanie cache mogą ulegać zmianie niezależnie od migracji Node.
Niestandardowe akcje JavaScript wymagają innego podejścia
Jeśli utrzymujesz własną akcję JavaScript, sprawdź jej action.yml lub action.yaml. Akcja JavaScript może wciąż zawierać:
runs:
using: node20
main: dist/index.js
Deklaracja środowiska powinna wskazywać Node 24:
runs:
using: node24
main: dist/index.js
Zmiana tej linii to tylko początek. Przetestuj akcję pod Node 24, zaktualizuj zależności tam, gdzie to konieczne, i przebuduj wszelkie skommitowane bundla dist/. W przeciwnym razie konsumenci mogą wciąż wykonywać stary wygenerowany kod JavaScript, mimo że źródło się zmieniło.
Bezpieczna migracja to: zaktualizuj środowisko deweloperskie, zaktualizuj zależności, zmień runs.using, przebuduj rozproszony JavaScript, uruchom testy, przetestuj akcję w prawdziwym workflow, a następnie opublikuj nową wersję.
Samohostowane runnery wymagają szczególnej uwagi
GitHub-hostowane runnery są utrzymywane przez GitHub. Samohostowane runnery są inne. Aplikacja runnera zawiera pliki wykonywalne Node.js używane przez akcje JavaScript, co sprawia, że wersja runnera jest istotna. Ostatnie wersje akcji opartych na Node-24 wymagają wystarczająco nowego Actions Runnera.
Jeśli Twoja organizacja exploatuje samohostowane runnery, uwzględnij ich wersje, systemy operacyjne i architektury w audycie migracji, zamiast patrzeć tylko na pliki YAML workflow. Stare systemy operacyjne mogą stać się ukrytą blokadą, ponieważ Node 24 zmienia bazowy zakres wspieranych platform.
CodeQL ma własną ścieżkę migracji
Repozytoria korzystające ze skanowania kodu GitHub powinny sprawdzić również swoje workflow CodeQL. CodeQL Action v4 korzysta ze środowiska uruchomieniowego Node.js 24. Zaawansowane konfiguracje CodeQL powinny zostać sprawdzone pod kątem starszych referencji github/codeql-action i zmigrowane zgodnie z aktualną wskazówką GitHub dotyczącą kompatybilności.
Przydatne polecenie audytu
Na maszynie deweloperskiej z systemem Unix-like, szybki pierwszy przegląd to:
grep -R "uses:" .github/workflows
Dla niestandardowych akcji wewnątrz repozytorium:
grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"
Te wyszukiwania nie dowodzą kompatybilności, ale zapewniają efektywny spis. Celem jest odpowiedź na trzy pytania: jakie akcje są używane, jakie wersje są przypięte, a jakie niestandardowe akcje wciąż deklarują przestarzałe środowisko?
Czy akcje powinny być przypięte do tagów czy commit SHA?
Migracja środowiska uruchomieniowego to również dobry moment na przegląd higieny łańcucha dostaw. Referencja taka jak vendor/action@v4 może zostać przesunięta przez jej utrzymującego, podczas gdy pełny commit SHA identyfikuje niezmienną rewizję.
Dla workflow wrażliwych na bezpieczeństwo, przypinanie third-party akcji do pełnych commit SHA może zmniejszyć ryzyko nieoczekiwanych zmian kodu. Kompromisem jest utrzymanie: aktualizacje wymagają wtedy celowego procesu lub narzędzi do aktualizacji zależności.
Bądź szczególnie ostrożny z uprzywilejowanymi workflow pull-request
Aktualizacja starych akcji jest ważna, ale model bezpieczeństwa workflow ma jeszcze większe znaczenie. pull_request_target może działać z dostępem do tokena repozytorium bazowego, sekretów i cache. Sprawdzanie kodu pull-request kontrolowanego przez atakującego wewnątrz takiego uprzywilejowanego workflow może stworzyć poważną lukę w łańcuchu dostaw.
Przy audycie plików workflow pod kątem Node 24, sprawdzaj ich triggery i uprawnienia w tym samym czasie. Nowoczesne środowisko uruchomieniowe nie czyni niebezpiecznego workflow bezpiecznym.
Praktyczna lista kontrolna migracji
Zacznij od wyliczenia wszystkich referencji uses: w .github/workflows. Zaktualizuj przestarzałe oficjalne akcje po przejrzeniu informacji o wersji. Sprawdź każdą third-party akcję pod kątem utrzymywanej wersji kompatybilnej z Node-24. Przeszukaj metadane niestandardowych akcji pod kątem node20, zmigruj je do node24, przebuduj bundla i przetestuj.
Dla samohostowanych runnerów, zweryfikuj wersję runnera, system operacyjny i architekturę. Przejrzyj zaawansowane workflow CodeQL. Na koniec, przetestuj ważne workflow release, zaplanowane i deploymentowe oraz domyślną ścieżkę CI, ponieważ rzadko używane joby to miejsce, gdzie najczęściej przetrwują stare wersje akcji.
Dlaczego ta migracja jest wararta zrobienia porządnie
Migracje środowiska Node.js wewnątrz GitHub Actions mogą wyglądać na problem infrastruktury kogoś innego. Nie są. Akcje to wykonywalne zależności w Twoim systemie CI/CD. Mogą budować release, obsługiwać poświadczenia, przesyłać artefakty i wdrażać aplikacje produkcyjne.
Przejście GitHub z Node 20 na Node 24 jest więc przydatną przypominką, że zależności CI mają cykle życia podobnie jak zależności aplikacji.
Bezpośrednie zadanie jest proste: usuń pozostałe zależności od przestarzałych akcji JavaScript i zaktualizuj infrastrukturę samohostowaną tam, gdzie to konieczne. Dłuższa lekcja jest bardziej cenne: traktuj .github/workflows jako utrzymywaną infrastrukturę aplikacyjną, a nie jako konfigurację, którą można napisać raz i zapomnieć.
Repozytorium, które okresowo audytuje swoje akcje, wersje runnerów, uprawnienia i third-party zależności, będzie znacznie lepiej przygotowane na następną przejściową migrację środowiska — i znacznie bezpieczniejsze między migracjami.