GitHub Actions удалил Node.js 20: как проверить и исправить ваши рабочие процессы
GitHub Actions больше не предоставляет среду выполнения Node.js 20 для JavaScript‑действий. Даже если ваше приложение не использует Node.js, старый checkout, setup или стороннее действие теперь могут стать проблемой CI. Вот как проверить ваши рабочие процессы, обновить пользовательские действия и безопасно проверить совместимость самохостинговых раннеров.
Рабочий процесс GitHub Actions может зависеть от Node.js даже тогда, когда проект, который он собирает, не содержит ни строчки JavaScript-кода.
Эта деталь стала важной.
23 сентября 2026 года GitHub завершил удаление Node.js 20 из раннеров GitHub Actions. JavaScript-действия теперь выполняются на Node.js 24, а временный переключатель совместимости, который ранее позволял пользователям оставаться на Node 20, больше недоступен.
Для многих репозиториев ничего менять не нужно. Текущие версии официальных действий GitHub уже перешли на Node 24.
Старые рабочие процессы, пользовательские JavaScript-действия и некоторые самостоятельно размещаемые раннеры заслуживают аудита.
Важно понимать, о каком именно рантайме Node.js идет речь в GitHub.
Рантайм вашего приложения и рантайм вашего действия — это разные вещи
Рассмотрим PHP-проект с таким рабочим процессом:
steps:
- uses: actions/checkout@v4
- name: Install dependencies
run: composer install
- name: Run tests
run: vendor/bin/phpunit
Приложение написано на PHP. Но actions/checkout — это само по себе JavaScript-действие. GitHub выполняет его JavaScript-код, используя рантайм Node.js, поставляемый вместе с раннером Actions.
Этот рантайм независим от Node.js, установленного вашим рабочим процессом. Так же actions/setup-node может установить Node 22 для последующих команд рабочего процесса, пока само действие выполняется с рантаймом, объявленным в его метаданных.
Это различие объясняет, почему удаление Node 20 потенциально затрагивает проекты на PHP, Python, Go, Java и других языках, не связанных с Node.
Что именно изменилось?
GitHub заранее объявил об устаревании Node 20, потому что Node.js 20 достиг конца жизненного цикла в апреле 2026 года. GitHub начал переключать Actions на Node 24 по умолчанию в июне 2026 года. В период миграции пользователи могли временно вернуться к устаревшему рантайму с помощью ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION. Это был лишь способ безопасной миграции.
23 сентября 2026 года GitHub удалил Node 20 из раннеров GitHub Actions и убрал этот параметр отката. Если поддерживаемое вами действие всё ещё объявляет Node 20, рекомендация GitHub — обновить его до Node 24 и опубликовать новый релиз.
Первый аудит: проверьте каждую строку uses:
Простейший аудит рабочего процесса начинается в .github/workflows. Найдите uses: и составьте инвентарь официальных и сторонних действий. Не считайте рабочий процесс актуальным только потому, что он всё ещё выполняется.
Для каждого действия определите, поддерживает ли версия, на которую ссылается ваш рабочий процесс, Node 24. Сторонним действиям уделяйте особое внимание: изучите их историю релизов перед слепым изменением мажорных версий. Входные параметры, значения по умолчанию, механизмы аутентификации и поведение кэша могут меняться независимо от миграции Node.
Пользовательские JavaScript-действия требуют другого подхода
Если вы поддерживаете своё JavaScript-действие, проверьте его action.yml или action.yaml. JavaScript-действие может всё ещё содержать:
runs:
using: node20
main: dist/index.js
Объявление рантайма должно указывать на Node 24:
runs:
using: node24
main: dist/index.js
Изменение этой строки — только начало. Протестируйте действие под Node 24, обновите зависимости при необходимости и пересоберите любой закоммиченный бандл dist/. Иначе потребители могут продолжать выполнять старый сгенерированный JavaScript-код, даже если исходный код изменился.
Безопасная миграция: обновите среду разработки, обновите зависимости, измените runs.using, пересоберите распространяемый JavaScript, запустите тесты, протестируйте действие в реальном рабочем процессе и только потом опубликуйте новый релиз.
Самостоятельно размещаемые раннеры требуют особого внимания
GitHub-хостинговые раннеры обслуживаются GitHub. Самостоятельно размещаемые раннеры — другое дело. Приложение раннера содержит исполняемые файлы Node.js, используемые JavaScript-действиями, поэтому версия раннера важна. Недавние релизы действий на базе Node 24 требуют достаточно новой версии Actions Runner.
Если ваша организация использует самостоятельно размещаемые раннеры, включите их версии, операционные системы и архитектуры в аудит миграции, а не смотрите только на YAML рабочих процессов. Старые операционные системы могут стать скрытым блокером, потому что Node 24 меняет базовую линию поддерживаемых платформ.
У CodeQL свой путь миграции
Репозитории, использующие сканирование кода GitHub, должны проверить свой рабочий процесс CodeQL. CodeQL Action v4 использует рантайм Node.js 24. Продвинутые настройки CodeQL следовательно нужно проверить на наличие старых ссылок github/codeql-action и выполнить миграцию в соответствии с текущими рекомендациями GitHub по совместимости.
Полезная команда для аудита
На Unix-подобной машине разработчика быстрый первый проход выглядит так:
grep -R "uses:" .github/workflows
Для пользовательских действий внутри репозитория:
grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"
Эти поиски не доказывают совместимость, но дают эффективный инвентарь. Цель — ответить на три вопроса: какие действия используются, какие версии закреплены и какие пользовательские действия всё ещё объявляют устаревший рантайм?
Стоит ли закреплять действия на тегах или коммитах SHA?
Миграция рантайма — также хорошая возможность проверить гигиену цепочки поставок. Ссылка вроде vendor/action@v4 может быть перемещена её сопровождающим, а полный SHA коммита идентифицирует неизменяемую ревизию.
Для рабочих процессов, чувствительных к безопасности, закрепление сторонних действий на полных SHA коммитов может снизить риск неожиданных изменений кода. Компромисс — в обслуживании: обновления тогда требуют намеренного процесса или инструментов обновления зависимостей.
Будьте особенно осторожны с привилегированными рабочими процессами pull request
Обновление старых действий важно, но модель безопасности рабочего процесса важна ещё больше. pull_request_target может выполняться с доступом к токену базового репозитория, секретам и кэшу. Извлечение кода pull request, контролируемого злоумышленником, внутри такого привилегированного рабочего процесса может создать серьезную уязвимость цепочки поставок.
При аудите файлов рабочих процессов на предмет Node 24 проверяйте их триггеры и разрешения одновременно. Современный рантайм не делает небезопасный рабочий процесс безопасным.
Практический чек-лист миграции
Начните с составления списка всех ссылок uses: в .github/workflows. Обновите устаревшие официальные действия после изучения заметок к релизам. Проверьте каждое стороннее действие на наличие поддерживаемой версии, совместимой с Node 24. Найдите в метаданных пользовательских действий node20, перенесите на node24, пересоберите бандлы и протестируйте.
Для самостоятельно размещаемых раннеров проверьте версию раннера, операционную систему и архитектуру. Проверьте продвинутые рабочие процессы CodeQL. Наконец, протестируйте важные рабочие процессы релизов, запланированных задач и развертываний, а также путь CI по умолчанию, потому что редко используемые задания — там, где часто выживают старые версии действий.
Почему эту миграцию стоит сделать как следует
Миграции рантайма Node.js внутри GitHub Actions могут выглядеть как чья-то инфраструктурная проблема. Они таковой не являются. Действия — это исполняемые зависимости в вашей системе CI/CD. Они могут собирать релизы, обрабатывать учетные данные, загружать артефакты и развертывать продакшн-приложения.
Переход GitHub с Node 20 на Node 24 — полезное напоминание о том, что CI-зависимости имеют жизненные циклы точно так же, как зависимости приложения.
Немедленная задача проста: устранить оставшиеся зависимости от устаревших JavaScript-действий и обновить самостоятельно размещаемую инфраструктуру там, где это необходимо. Более долгосрочный урок ценнее: относитесь к .github/workflows как к поддерживаемой инфраструктуре приложения, а не как к конфигурации, которую можно написать один раз и забыть.
Репозиторий, который периодически аудитирует свои действия, версии раннеров, разрешения и сторонние зависимости, будет гораздо лучше подготовлен к следующему переходу рантайма — и значительно безопаснее между миграциями.