GitHub Actions Remove Node.js 20: Como Auditar e Corrigir Seus Fluxos de Trabalho
GitHub Actions não fornece mais o runtime Node.js 20 para ações JavaScript. Mesmo que seu aplicativo não use Node.js, um checkout antigo, setup ou ação de terceiros pode agora se tornar um problema de CI. Aqui está como auditar seus fluxos de trabalho, atualizar ações personalizadas e verificar os runners auto-hospedados com segurança.
GitHub Actions removeu o Node.js 20: Como auditar e corrigir seus fluxos de trabalho
Um fluxo de trabalho do GitHub Actions pode depender do Node.js mesmo quando o projeto que ele build não contém nenhum JavaScript.
Esse detalhe se tornou importante.
Em 23 de setembro de 2026, o GitHub concluiu a remoção do Node.js 20 dos runners do GitHub Actions. As ações JavaScript agora rodam no Node.js 24, e o switch de compatibilidade temporário que anteriormente permitia aos usuários permanecer no Node 20 não está mais disponível.
Para muitos repositórios, nada precisa mudar. As versões atuais das ações de primeira parte do GitHub já migraram para o Node 24.
Fluxos de trabalho mais antigos, ações JavaScript personalizadas e alguns runners auto-hospedados merecem uma auditoria, no entanto.
A distinção importante é entender qual runtime do Node.js o GitHub está mencionando.
O runtime da sua aplicação e o runtime da sua Action são coisas diferentes
Considere um projeto PHP com este fluxo de trabalho:
steps:
- uses: actions/checkout@v4
- name: Install dependencies
run: composer install
- name: Run tests
run: vendor/bin/phpunit
A aplicação é PHP. Mas actions/checkout é em si uma ação JavaScript. O GitHub executa seu JavaScript usando um runtime do Node.js empacotado com o runner do Actions.
Esse runtime é independente do Node.js instalado pelo seu fluxo de trabalho. Da mesma forma, actions/setup-node pode instalar o Node 22 para comandos subsequentes do fluxo de trabalho enquanto a ação em si executa com o runtime declarado em seus metadados.
Essa distinção explica por que a remoção do Node 20 pode afetar potencialmente projetos PHP, Python, Go, Java e outros não-Node.
O que exatamente mudou?
O GitHub anunciou a depreciação do Node 20 com bastante antecedência porque o Node.js 20 atingiu o fim do ciclo de vida em abril de 2026. O GitHub começou a mudar as Actions para o Node 24 por padrão em junho de 2026. Durante o período de migração, os usuários podiam optar temporariamente por voltar ao runtime obsoleto com ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION. Isso era apenas uma válvula de escape de migração.
Em 23 de setembro de 2026, o GitHub removeu o Node 20 dos runners do GitHub Actions e removeu essa opção de desativação. Se uma ação que você mantém ainda declara o Node 20, a recomendação do GitHub é atualizá-la para o Node 24 e publicar um novo release.
Primeira auditoria: inspecione cada linha uses:
A auditoria de fluxo de trabalho mais simples começa em .github/workflows. Procure por uses: e faça um inventário das ações de primeira parte e de terceiros. Não assuma que um fluxo de trabalho está atualizado apenas porque ainda executa.
Para cada ação, determine se a versão referenciada pelo seu fluxo de trabalho é um release atual que suporta o Node 24. Ações de terceiros merecem atenção particular: verifique o histórico de releases antes de alterar versões principais às cegas. Entradas, padrões, mecanismos de autenticação e comportamento de cache podem mudar independentemente da migração do Node.
Ações JavaScript personalizadas exigem uma correção diferente
Se você mantém sua própria ação JavaScript, inspecione seu action.yml ou action.yaml. Uma ação JavaScript pode ainda conter:
runs:
using: node20
main: dist/index.js
A declaração de runtime deve apontar para o Node 24:
runs:
using: node24
main: dist/index.js
Alterar essa linha é apenas o começo. Teste a ação sob o Node 24, atualize dependências onde necessário e reconstrua qualquer bundle dist/ commitado. Caso contrário, consumidores podem continuar executando JavaScript gerado antigo mesmo que a fonte tenha mudado.
Uma migração segura é atualizar o ambiente de desenvolvimento, atualizar dependências, alterar runs.using, reconstruir o JavaScript distribuído, executar testes, exercitar a ação em um fluxo de trabalho real e então publicar um novo release.
Runners auto-hospedados precisam de atenção especial
Runners hospedados pelo GitHub são mantidos pelo GitHub. Runners auto-hospedados são diferentes. O aplicativo do runner contém os executáveis do Node.js usados por ações JavaScript, tornando a versão do runner importante. Releases recentes de ações baseadas no Node 24 exigem um Actions Runner suficientemente recente.
Se sua organização opera runners auto-hospedados, inclua suas versões, sistemas operacionais e arquiteturas na auditoria de migração em vez de olhar apenas para o YAML do fluxo de trabalho. Sistemas operacionais antigos podem se tornar o bloqueador oculto porque o Node 24 altera a linha de base da plataforma suportada.
CodeQL tem seu próprio caminho de migração
Repositórios que usam a varredura de código do GitHub também devem inspecionar seu fluxo de trabalho do CodeQL. CodeQL Action v4 usa o runtime do Node.js 24. Configurações avançadas do CodeQL devem, portanto, ser verificadas quanto a referências mais antigas a github/codeql-action e migradas de acordo com a orientação atual de compatibilidade do GitHub.
Um comando de auditoria útil
Em uma máquina de desenvolvimento semelhante ao Unix, uma primeira passagem rápida é:
grep -R "uses:" .github/workflows
Para ações personalizadas dentro do repositório:
grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"
Essas buscas não comprovam compatibilidade, mas fornecem um inventário eficiente. O objetivo é responder a três perguntas: quais ações são usadas, quais versões estão fixadas e quais ações personalizadas ainda declaram um runtime obsoleto?
As ações devem ser fixadas em tags ou SHAs de commit?
Uma migração de runtime também é uma boa oportunidade para revisar a higiene da cadeia de suprimentos. Uma referência como vendor/action@v4 pode ser movida por seu mantenedor, enquanto um SHA de commit completo identifica uma revisão imutável.
Para fluxos de trabalho sensíveis à segurança, fixar ações de terceiros a SHAs de commit completos pode reduzir o risco de mudanças inesperadas de código. A compensação é a manutenção: atualizações então requerem um processo deliberado ou ferramentas de atualização de dependências.
Tenha cuidado especial com fluxos de trabalho de pull request privilegiados
Atualizar ações antigas é importante, mas o modelo de segurança do fluxo de trabalho importa ainda mais. pull_request_target pode executar com acesso ao token, segredos e cache do repositório base. Fazer checkout de código de pull request controlado por atacante dentro de um fluxo de trabalho privilegiado como esse pode criar uma vulnerabilidade séria na cadeia de suprimentos.
Ao auditar arquivos de fluxo de trabalho para o Node 24, inspecione seus gatilhos e permissões ao mesmo tempo. Um runtime moderno não torna um fluxo de trabalho inseguro seguro.
Uma lista prática de migração
Comece listando todas as referências uses: em .github/workflows. Atualize ações de primeira parte obsoletas após revisar as notas de lançamento. Verifique cada ação de terceiros por uma versão mantida compatível com Node 24. Pesquise metadados de ação personalizada para node20, migre-o para node24, reconstrua bundles e teste.
Para runners auto-hospedados, verifique a versão do runner, sistema operacional e arquitetura. Revise fluxos de trabalho avançados do CodeQL. Finalmente, exerça fluxos de trabalho importantes de release, agendados e de implantação, bem como o caminho CI padrão, porque jobs raramente usados são onde versões antigas de ações frequentemente sobrevivem.
Por que vale a pena fazer esta migração corretamente
Migrações de runtime do Node.js dentro do GitHub Actions podem parecer um problema de infraestrutura de outra pessoa. Não são. As ações são dependências executáveis no seu sistema CI/CD. Elas podem criar releases, lidar com credenciais, fazer upload de artefatos e implantar aplicações de produção.
Portanto, a mudança do GitHub do Node 20 para o Node 24 é um lembrete útil de que dependências de CI têm ciclos de vida assim como dependências de aplicação.
A tarefa imediata é direta: remover dependências restantes em ações JavaScript obsoletas e atualizar infraestrutura auto-hospedada onde necessário. A lição de longo prazo é mais valiosa: trate .github/workflows como infraestrutura de aplicação mantida, não como configuração que pode ser escrita uma vez e esquecida.
Um repositório que audita periodicamente suas ações, versões de runner, permissões e dependências de terceiros estará muito melhor preparado para a próxima transição de runtime—e consideravelmente mais seguro entre migrações.