GitHub Actions elimină Node.js 20: Cum să auditezi și să repari fluxurile de lucru
GitHub Actions nu mai oferă runtime-ul Node.js 20 pentru acțiunile JavaScript. Chiar dacă aplicația ta nu utilizează Node.js, o verificare veche, configurare sau acțiune terță parte poate deveni acum o problemă CI. Iată cum să auditezi fluxurile de lucru, să actualizezi acțiunile personalizate și să verifici în siguranță runner-urile self-hosted.
GitHub Actions a eliminat Node.js 20: Cum să auditezi și să repari fluxurile de lucru
Un flux de lucru GitHub Actions poate depinde de Node.js chiar și atunci când proiectul pe care îl construiește nu conține deloc JavaScript.
Acest detaliu a devenit important.
Pe 23 septembrie 2026, GitHub a finalizat eliminarea Node.js 20 de la rulătorii GitHub Actions. Acțiunile JavaScript rulează acum pe Node.js 24, iar comutatorul temporar de compatibilitate care permitea anterior utilizatorilor să rămână pe Node 20 nu mai este disponibil.
Pentru multe depozite, nimic nu trebuie schimbat. Versiunile curente ale acțiunilor de parte întâi ale GitHub-ului au trecut deja la Node 24.
Totuși, fluxurile de lucru mai vechi, acțiunile JavaScript personalizate și unele rulători auto-găzduiți merită o auditare.
Distincția importantă este să înțelegi care mediu de rulare Node.js menționează GitHub.
Mediul de rulare al aplicației și mediul de rulare al acțiunii sunt lucruri diferite
Să luăm în considerare un proiect PHP cu acest flux de lucru:
steps:
- uses: actions/checkout@v4
- name: Install dependencies
run: composer install
- name: Run tests
run: vendor/bin/phpunit
Aplicația este PHP. Dar actions/checkout este în sine o acțiune JavaScript. GitHub execută JavaScript-ul său folosind un mediu de rulare Node.js inclus cu rulătorul Acțiunilor.
Acest mediu de rulare este independent de Node.js instalat de fluxul tău de lucru. Similar, actions/setup-node poate instala Node 22 pentru comenzi ulterioare de flux de lucru, în timp ce acțiunea în sine se execută cu mediul de rulare declarat în metadatele sale.
Această distincție explică de ce eliminarea Node 20 poate afecta potențial proiecte PHP, Python, Go, Java și alte proiecte non-Node.
Ce s-a schimbat exact?
GitHub a anunțat cu mult înainte învechirea Node 20 deoarece Node.js 20 a atins sfârșitul duratei de viață în aprilie 2026. GitHub a început comutarea Acțiunilor la Node 24 ca valoare implicită în iunie 2026. În perioada de migrare, utilizatorii au putut să se întoarcă temporar la mediul de rulare învechit cu ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION. Aceasta era doar o soluție temporară de evitare a migrației.
Pe 23 septembrie 2026, GitHub a eliminat Node 20 de la rulătorii GitHub Actions și a eliminat această opțiune de excluare. Dacă o acțiune pe care o țineți menținut declara încă Node 20, recomandarea GitHub este să o actualizați la Node 24 și să publicați o nouă versiune.
Auditați întâi: inspeționați fiecare linie uses:
Cel mai simplu audit al fluxului de lucru începe în .github/workflows. Căutați uses: și faceți un inventar al acțiunilor de parte întâi și ale celor de terțe părți. Nu presupuneți că un flux de lucru este curent numai pentru că rulează încă.
Pentru fiecare acțiune, determinați dacă versiunea referențiată de fluxul vostru de lucru este o versiune curentă care susține Node 24. Acțiunile de terțe părți merită o atenție deosebită: verificați istoricul lor de lansări înainte de a schimba major versioanele în mod oarbă. Intrările, valorile implicite, mecanismele de autentificare și comportamentul cache-ului pot schimba independent de migrarea Node.
Acțiunile JavaScript personalizate necesită o corecție diferită
Dacă țineți o proprie acțiune JavaScript, inspeționați action.yml sau action.yaml ale acesteia. O acțiune JavaScript poate conține încă:
runs:
using: node20
main: dist/index.js
Declarația mediului de rulare ar trebui să țintească Node 24:
runs:
using: node24
main: dist/index.js
Schimbarea acelei linii este doar începutul. Testați acțiunea sub Node 24, actualizați dependințele unde este necesar și reconstruiți orice pachet dist/ comitat. În caz contrar, consumatorii pot continua să execute JavaScript-ul generat vechi chiar dacă sursa s-a schimbat.
O migrare sigură este să actualizați mediul de dezvoltare, să actualizați dependințele, să schimbați runs.using, să reconstruiți JavaScript-ul distribuit, să rulați teste, să testați acțiunea într-un flux de lucru real și apoi să publicați o nouă versiune.
Rulătorii auto-găzduiți necesită atenție deosebită
Rulătorii găzduiți de GitHub sunt menținate de GitHub. Rulătorii auto-găzduiți sunt diferiți. Aplicația rulătorului conține executabilele Node.js utilizate de acțiunile JavaScript, ceea ce face versiunea rulătorului importantă. Lansările recente de acțiuni bazate pe Node 24 necesită un rulător Acțiuni suficient de recent.
Dacă organizația dvs. utilizează rulători auto-găzduiți, includeți versiunile lor, sistemele de operare și arhitecturile în auditul de migrare în locul de a vă uita doar la YAML-ul fluxului de lucru. Sistemele de operare vechi pot deveni obstacolul ascuns deoarece Node 24 modifică baza platformei suportate.
CodeQL are propria cale de migrare
Depozitele care utilizează verificarea codului GitHub ar trebui să inspeționeze și fluxul lor CodeQL. Acțiunea CodeQL v4 utilizează mediul de rulare Node.js 24. Configurațiile CodeQL avansate ar trebui verificate deci pentru referințele github/codeql-action mai vechi și migrate conform ghidului curent de compatibilitate al GitHub-ului.
O comandă utilă de auditare
Pe o mașină de dezvoltare de tip Unix, o trecere rapidă inițială este:
grep -R "uses:" .github/workflows
Pentru acțiunile personalizate în interiorul depozitului:
grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"
Aceste căutări nu dovedesc compatibilitatea, dar oferă un inventar eficient. Scopul este să răspundeți la trei întrebări: ce acțiuni sunt utilizate, ce versiuni sunt fixate și ce acțiuni personalizate declară încă un mediu de rulare învechit?
Ar trebui acțiunile fixate la etichete sau SHA-uri de commit?
O migrare de mediu de rulare este, de asemenea, o bună ocazie de a revizui igiena lanțului de aprovizionare. O referință ca vendor/action@v4 poate fi mutată de menținătorul său, în timp ce un SHA de commit complet identifică o revisie imutabilă.
Pentru fluxurile de lucru sensibile la securitate, fixarea acțiunilor de terțe părți la SHA-uri de commit complete poate reduce riscul de modificări neașteptate ale codului. Compromisul este mentenanța: actualizările necesită atunci un proces deliberat sau unelte de actualizare a dependințelor.
Fii în special atent cu fluxurile de lucru pull-request privilegiale
pull_request_target poate rula cu acces la tokenul, secretele și cache-ul depozitului de bază. Preluarea codului de pull-request controlat de atacator într-un astfel de flux de lucru cu privilegii poate crea o vulnerabilitate serioasă a lanțului de aprovizionare.
Când auditează fișierele de flux de lucru pentru Node 24, inspectați declanșătorii și permisiunile în același timp. Un mediu de rulare modern nu face un flux de lucru nesigur securizat.
O listă practică de verificare pentru migrare
Începeți prin a lista toate referințele uses: în .github/workflows. Actualizați acțiunile de parte întâi învechite după revizuirea notelor de lansare. Verificați fiecare acțiune de terțe părți pentru o versiune menținută compatibilă cu Node 24. Căutați în metadatele acțiunilor personalizate node20, migrați-l la node24, reconstruiți pachetele și testați.
Pentru rulătorii auto-găzduiți, verificați versiunea rulătorului, sistemul de operare și arhitectura. Revizuiți fluxurile CodeQL avansate. În cele din urmă, testați fluxurile importante de lansare, programate și de implementare, precum și calea CI implicită, deoarece sarcinile rar utilizate sunt locul unde versiunile vechi ale acțiunilor supraviețuiesc de obicei.
De ce această migrare merită să fie făcută corect
Migrațiile mediului de rulare Node.js în interiorul GitHub Actions pot pară problema infrastructurală a altcuia. Ele nu sunt. Acțiunile sunt dependințe executabile în sistemul dvs. CI/CD. Ele pot construi versiuni, gestiona credențiale, încărca artefacte și desplasează aplicații de producție.
Mutarea GitHub-ului de la Node 20 la Node 24 este deci o amintire utilă că dependințele CI au cicluri de viață similar cu dependințele aplicației.
Sarcina imediată este simplă: eliminați dependințele rămase pe acțiuni JavaScript învechite și actualizați infrastructura auto-găzduită unde este cazul. Lecția pe termen lung este mai valoroasă: tratați .github/workflows ca pe infrastructură de aplicație menținută, nu ca pe configurare care poate fi scrisă o dată și uitată.
Un depozit care auditează periodic acțiunile sale, versiunile rulătorului, permisiunile și dependințele de terțe părți va fi mult mai bine pregătit pentru următoarea tranziție de mediu de rulare—și considerațional mai sigur între migrații.