GitHub Actions ha rimosso Node.js 20: Come eseguire l'audit e correggere i tuoi flussi di lavoro
GitHub Actions non fornisce più il runtime Node.js 20 per le azioni JavaScript. Anche se la tua applicazione non utilizza Node.js, un vecchio checkout, setup o azione di terze parti può ora diventare un problema di CI. Ecco come eseguire l'audit dei tuoi flussi di lavoro, aggiornare le azioni personalizzate e verificare i runner self-hosted in modo sicuro.
GitHub Actions ha rimosso Node.js 20: come auditare e correggere i tuoi workflow
Una GitHub Actions workflow può dipendere da Node.js anche quando il progetto che builda non contiene affatto JavaScript.
Quel dettaglio è diventato importante.
Il 23 settembre 2026, GitHub ha completato la rimozione di Node.js 20 dai runner di GitHub Actions. Le action JavaScript ora eseguono su Node.js 24, e la switch di compatibilità temporanea che precedentemente consentiva agli utenti di restare su Node 20 non è più disponibile.
Per molti repository non serve cambiare nulla. Le versioni attuali delle action first-party di GitHub hanno già spostato su Node 24.
Tuttavia, i vecchi workflow, le action JavaScript personalizzate e alcuni runner self-hosted meritano un audit.
La distinzione importante è comprendere quale runtime Node.js GitHub stia parlando.
Il runtime della tua applicazione e il tuo runtime Action sono cose diverse
Considera un progetto PHP con questo workflow:
steps:
- uses: actions/checkout@v4
- name: Install dependencies
run: composer install
- name: Run tests
run: vendor/bin/phpunit
L'applicazione è PHP. Ma actions/checkout è esso stesso un action JavaScript. GitHub esegue il suo JavaScript usando un runtime Node.js bundle con l'Actions runner.
Questo runtime è indipendente da Node.js installato dal workflow. Allo stesso modo, actions/setup-node può installare Node 22 per i comandi workflow successivi mentre l'action stesso esegue con il runtime dichiarato nei metadati.
Quella distinzione spiega perché la rimozione di Node 20 può interessare potenzialmente progetti PHP, Python, Go, Java e altri progetti non Node.
Cosa è cambiato esattamente?
GitHub ha annunciato la deprecazione di Node 20 molto in anticipo perché Node.js 20 ha raggiunto la fine vita in April 2026. GitHub ha iniziato a passare le Actions a Node 24 per impostazione predefinita in June 2026. Durante il periodo di migrazione, gli utenti potevano temporaneamente tornare al runtime obsoleto con ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION. Quello era solo una via di fuga per la migrazione.
Il 23 settembre 2026, GitHub ha rimosso Node 20 dai runner di GitHub Actions e ha rimosso quell'opzione. Se un action che mantieni dichiara ancora Node 20, il consiglio di GitHub è di aggiornarlo a Node 24 e pubblicare una nuova release.
Primo audit: ispeziona ogni riga uses:
La semplice audit di workflow inizia in .github/workflows. Cerca uses: e inventaria le action first-party e third-party. Non assumere che un workflow sia attuale semplicemente perché continua a eseguirsi.
Per ogni action, determinare se la versione referenziata dal tuo workflow è una release attuale che supporta Node 24. Le action third-party meritano particolare attenzione: controlla la loro cronologia delle release prima di cambiare blindamente le versioni major. Input, valori predefiniti, meccanismi di autenticazione e comportamento della cache possono cambiare indipendentemente dalla migrazione Node.
Le action JavaScript personalizzate richiedono una correzione diversa
Se mantieni la tua action JavaScript, ispeziona i suoi action.yml o action.yaml. Un action JavaScript potrebbe ancora contenere:
runs:
using: node20
main: dist/index.js
La dichiarazione del runtime dovrebbe puntare a Node 24:
runs:
using: node24
main: dist/index.js
Cambiare quella riga è solo l'inizio. Testare l'action sotto Node 24, aggiornare le dipendenze dove necessario e ricompilare eventuale bundle dist/ committato. In caso contrario, i consumer potrebbero continuare a eseguire vecchio JavaScript generato anche se la fonte è cambiata.
Una migrazione sicura è aggiornare l'ambiente di sviluppo, aggiornare le dipendenze, cambiare runs.using, ricompilare il JavaScript distribuito, eseguire i test, esercitare l'action in un workflow reale e poi pubblicare una nuova release.
I runner self-hosted richiedono attenzione particolare
Le runner GitHub-hosted sono mantenute da GitHub. Le runner self-hosted sono diverse. L'applicazione runner contiene gli eseguibili Node.js usati dalle action JavaScript, rendendo importante la versione del runner. Le recenti release di action basate su Node 24 richiedono un Actions Runner sufficientemente recente.
Se la tua organizzazione opera runner self-hosted, includi versioni, sistemi operativi e architetture nel migration audit invece di guardare solo al workflow YAML. Vecchi sistemi operativi possono diventare il blocker nascosto perché Node 24 cambia la baseline delle piattaforme supportate.
CodeQL ha il proprio percorso di migrazione
Anche i repository che usano il code scanning di GitHub dovrebbero ispezionare il loro workflow CodeQL. La CodeQL Action v4 usa il runtime Node.js 24. Le configurazioni avanzate di CodeQL dovrebbero quindi essere controllate per riferimenti più vecchi a github/codeql-action e migrate secondo le indicazioni di compatibilità attuali di GitHub.
Un comando utile per l'audit
In una macchina di sviluppo simile a Unix, un rapido primo passaggio è:
grep -R "uses:" .github/workflows
Per le action personalizzate dentro il repository:
grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"
Queste ricerche non provano la compatibilità, ma forniscono un inventario efficiente. L'obiettivo è rispondere a tre domande: quali action sono usate, quali versioni sono fissate e quali action personalizzate dichiarano ancora un runtime obsoleto?
Le action dovrebbero essere fissate a tag o commit SHA?
Una migrazione del runtime è anche un buon'opportunità per rivedere l'igiene della supply chain. Un riferimento come vendor/action@v4 può essere spostato dal suo manutentore, mentre un full commit SHA identifica una revisione immutabile.
Per workflow sensibili alla sicurezza, fissare le action third-party a full commit SHA può ridurre il rischio di cambiamenti inattesi al codice. Il compromesso è la manutenzione: gli aggiornamenti richiedono quindi un processo deliberato o uno strumento di aggiornamento delle dipendenze.
Fai particolare attenzione ai workflow privileged per pull request
Aggiornare le action vecchie è importante, ma il modello di sicurezza del workflow conta ancora di più. pull_request_target può eseguire con accesso al token, ai segreti e alla cache del repository base. Eseguire il checkout del codice di pull request controllato da un attaccante all'interno di un workflow privileged può creare una grave vulnerabilità della supply chain.
Quando si esegue l'audit dei file workflow per Node 24, ispezionare anche trigger e permessi contemporaneamente. Un runtime moderno non rende un workflow non sicuro sicuro.
Una checklist pratica per la migrazione
Inizia elencando tutti i riferimenti uses: in .github/workflows. Aggiorna le action first-party obsolete dopo aver esaminato le release notes. Controlla ogni action third-party per una versione mantenuta compatibile con Node 24. Cerca in metadati delle action personalizzate node20, migrala in node24, ricompila i bundle e testa.
Per i runner self-hosted, verificare versione del runner, sistema operativo e architettura. Rivedi i workflow CodeQL avanzati. Infine, esercitare i workflow importanti per release, pianificati e deployment oltre al percorso CI predefinito, perché i job raramente usati sono dove le vecchie versioni delle action spesso sopravvivono.
Perché questa migrazione vale la pena fare correttamente
Le migrazioni del runtime Node.js dentro GitHub Actions possono sembrare un problema di infrastruttura di qualcun altro. Non lo sono. Le action sono dipendenze eseguibili nel tuo sistema CI/CD. Possono buildare release, gestire credenziali, upload di artifact e deploy di applicazioni di produzione.
Il passaggio di GitHub da Node 20 a Node 24 è quindi un promemoria utile che le dipendenze CI/CD hanno cicli di vita proprio come le dipendenze delle applicazioni.
Il compito immediato è semplice: rimuovere le dipendenze residue da obsolete action JavaScript e aggiornare l'infrastruttura self-hosted dove necessario. La lezione a lungo termine è più preziosa: tratta .github/workflows come infrastruttura di applicazione mantenuta, non come configurazione che può essere scritta una volta e dimenticata.
Un repository che audita periodicamente le proprie action, le versioni del runner, i permessi e le dipendenze third-party sarà molto meglio preparato al prossimo passaggio del runtime—ed molto più sicuro tra le migrazioni.