23 сентября 2026 года GitHub удалил Node 20 из раннеров GitHub Actions. Теперь JavaScript-действия выполняются в Node 24, а временная возможность отказаться от обновления с помощью ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION больше недоступна. Авторы действий должны выпускать версии, в метаданных которых указано runs.using: node24, а владельцы рабочих процессов — переходить на совместимые версии.
На первый взгляд это обычное обновление зависимости. Для QA это миграция системы поставки. Приложение по-прежнему может успешно пройти все модульные тесты, но получение исходного кода, загрузка отчётов, кэширование, подписание или развёртывание могут завершиться сбоем до или после этих тестов. Поэтому цель шире, чем просто «сделать CI зелёным»: необходимо сохранить доказательства и контрольные проверки качества, которые обеспечивает конвейер.
1. Зафиксируйте подтверждённое изменение
Отделяйте факты поставщика от своих тестовых гипотез.
GitHub подтверждает:
- Node 20 больше недоступен в раннерах GitHub Actions.
- Раннеры используют Node 24 для JavaScript-действий.
- Прежний механизм отказа от перехода с Node 20 больше не работает.
- Node 24 несовместим с macOS 13.4 и более ранними версиями и официально не поддерживает ARM32.
- Авторам следует изменить метаданные JavaScript-действий на
node24, а пользователям — перейти на версии, поддерживающие Node 24.
Не превращайте эти факты в выдуманные правила, например в постоянное требование к минимальной версии раннера. GitHub со временем меняет требования к раннерам. При каждой миграции самостоятельно размещённых раннеров сверяйтесь с актуальной официальной документацией и информацией о выпусках.
Есть важный нюанс: шаг оболочки, выполняющий node -v, сообщает версию исполняемого файла Node, доступного через PATH. Он не доказывает, какая встроенная среда выполнила JavaScript-действие. Сведения о среде выполнения действия следует получать из его метаданных, диагностических данных раннера, аннотаций или инструментирования внутри самого действия.
2. Определите реальную область воздействия
Начните с инвентаризации всего репозитория, а не ждите сбоев заданий.
Проверьте:
- Все ссылки
uses:в файлах.github/workflows/*.ymlи.yaml. - Локальные действия в каталогах наподобие
.github/actions/. - Повторно используемые рабочие процессы, вызываемые через
workflow_call. - Составные действия и все вызываемые ими JavaScript-действия.
- Действия, используемые только в рабочих процессах выпуска, запланированных или запускаемых вручную.
- Метки, операционные системы, архитектуры и политику обновления самостоятельно размещённых раннеров.
Для каждого внешнего действия зафиксируйте точную ссылку, выпуск исходного проекта с поддержкой Node 24, репозиторий-источник и доказательства, на основании которых действие было одобрено. Плавающий тег основной версии удобен, но не является неизменяемым. В рекомендациях GitHub по безопасному использованию указано, что неизменяемую привязку действия обеспечивает полный SHA коммита. Если команда использует тег ради удобства сопровождения, документируйте этот компромисс и проверяйте, на какой коммит указывает тег.
Не полагайте, что обновление настроек среды приложения в самом рабочем процессе решает проблему. Например, изменение входного параметра setup-node влияет на версию Node, которую используют последующие команды оболочки, но не изменяет файл action.yml другого действия.
3. Составьте матрицу миграции на основе рисков
Расставляйте приоритеты по последствиям, а не по порядку файлов в конвейере.
| Область конвейера | Возможный сбой | Независимое доказательство |
|---|---|---|
| Получение исходного кода | Репозиторий или подмодули получены не полностью | Присутствуют ожидаемый SHA коммита и файл-маркер |
| Кэш зависимостей | Устаревший или нечитаемый кэш искажает результаты | Запуски с пустым и прогретым кэшем дают одинаковые результаты тестов |
| Выполнение тестов | Тесты проходят не в ожидаемой среде | Зафиксированы среда выполнения, ОС, архитектура и манифест зависимостей |
| Загрузка отчётов | Тесты завершены, но доказательства отсутствуют | Артефакт существует, открывается и соответствует идентификатору запуска |
| Выпуск и подписание | Проблемы с учётными данными или нативными зависимостями проявляются слишком поздно | Канареечная проверка вне продуктивной среды создаёт проверяемый подписанный тестовый артефакт |
| Развёртывание | Действие завершилось успешно, но целевое состояние неверно | Выполнена обратная проверка состояния целевой среды |
| Уведомления | Владелец не видит сбой | Намеренно вызванный тестовый сбой создаёт ожидаемое оповещение |
Выполните проверки из этой матрицы для каждого фактически используемого класса раннеров. Не добавляйте раннеры macOS или ARM только ради визуальной полноты матрицы: тестируйте среды, которые поддерживает ваша инфраструктура.
4. Рекомендации авторам действий
Для JavaScript-действия недостаточно изменить одну строку метаданных.
В метаданных необходимо указать Node 24:
runs:
using: node24
main: dist/index.jsЗатем повторно соберите зафиксированный в репозитории дистрибутив с помощью документированного набора инструментов проекта, запустите модульные тесты и выполните действие в отдельном рабочем процессе. Проверьте входные и выходные данные, обработку ошибок, операции с файлами, сетевые вызовы и очистку после выполнения действия. Нативные модули требуют особого внимания, поскольку их совместимость может зависеть от операционной системы и архитектуры.
Публикуйте новый выпуск только после того, как сгенерированное содержимое dist и файл action.yml будут согласованы. Пользователи не должны гадать, был ли существующий тег незаметно изменён.
5. Рекомендации пользователям рабочих процессов
Для каждого подключённого действия:
- откройте исходный репозиторий и найдите выпуск, в котором явно заявлена поддержка Node 24;
- изучите примечания к выпуску и метаданные;
- убедитесь, что выбранный тег или SHA относится к ожидаемому репозиторию;
- протестируйте его в изолированном канареечном рабочем процессе;
- обновляйте по одному классу зависимостей за раз, если иначе диагностика сбоя будет неоднозначной.
Не пытайтесь «исправить» миграцию, переключив все действия на @main. Так заметная проблема среды выполнения будет заменена неконтролируемым дрейфом цепочки поставок.
Полезная канареечная проверка выполняет ту же значимую для бизнеса операцию, что и в продуктивной среде, но использует одноразовые данные. Канареечная проверка получения исходного кода должна сверять полученный SHA. Канареечная проверка загрузки должна скачать и открыть загруженный артефакт. Канареечная проверка развёртывания должна выполнить публикацию в непродуктивную среду, и затем считать её состояние.
6. Правильно подтвердите встроенную среду выполнения
Авторы локального JavaScript-действия могут создать временное диагностическое действие:
# .github/actions/runtime-probe/action.yml
name: Runtime probe
runs:
using: node24
main: index.js// .github/actions/runtime-probe/index.js
console.log(JSON.stringify({
node: process.version,
platform: process.platform,
arch: process.arch
}));Вызовите это локальное действие для каждого релевантного класса раннеров и сохраните журнал как доказательство миграции. Так можно подтвердить среду выполнения, которую использовало конкретное JavaScript-действие. Отдельный шаг run: node -v по-прежнему полезен для команд приложения, но отвечает на другой вопрос.
Для сторонних действий, которые не могут напрямую сообщить свою среду выполнения, используйте метаданные исходного проекта и аннотации раннера, а также сквозную проверку наблюдаемого результата действия.
7. Относитесь к самостоятельно размещённым раннерам как к продукту
Раннеры, размещённые GitHub, обновляет сам GitHub. Самостоятельно размещённые раннеры добавляют обязанности их владельцу.
По умолчанию приложение самостоятельно размещённого раннера обновляется автоматически. Если автоматические обновления отключены, GitHub требует регулярно устанавливать новые версии. В актуальной документации указано, что раннер необходимо обновить в течение 30 дней после выхода новой версии, а при критических обновлениях безопасности постановка заданий в очередь может прекратиться до установки обновления.
Поэтому проверка раннера должна охватывать:
- текущую версию приложения раннера и режим обновления;
- поддерживаемые ОС и архитектуру;
- исходящие соединения, необходимые для работы действий;
- чистую рабочую область или эфемерный жизненный цикл;
- хранение журналов неудачных и эфемерных заданий;
- контролируемую процедуру замены образа раннера.
В контексте миграции на Node 24 найдите хосты с macOS 13.4 или более ранней версией, а также ARM32-хосты. Безопасное решение — обновить их или перенести задание на поддерживаемый раннер, а не восстанавливать удалённый обходной механизм Node 20.
8. Протестируйте обработку сбоев и восстановление
Не создавайте негативный тест, который намеренно запускает устаревшую продуктивную зависимость. Вместо этого внедряйте контролируемые сбои в канареечную проверку:
- недопустимое значение обязательного входного параметра;
- недоступная одноразовая конечная точка;
- повреждённый тестовый артефакт;
- отказ в разрешении на запись;
- отменённое задание;
- сбой очистки после выполнения действия.
Проверьте статус, сообщение об ошибке, сохранённые доказательства, очистку, политику повторных попыток и уведомление.
После удаления Node 20 вариант «откатиться к действию на Node 20» нельзя считать надёжным планом восстановления. Восстановление требует прямого исправления без отката: перейти на совместимый выпуск, исправить и протестировать контролируемый форк либо временно заменить проблемный шаг поддерживаемой реализацией. Для каждого временного форка зафиксируйте ответственного за решение и дату окончания его использования.
9. Пять вопросов, которые должен задать каждый проверяющий
- Какие рабочие процессы и локальные действия были фактически включены в инвентаризацию, в том числе запланированные и повторно используемые рабочие процессы?
- Какие доказательства подтверждают, что каждый выбранный выпуск действия поддерживает Node 24?
- Какой результат подтверждает реальный побочный эффект действия, а не только его код завершения?
- Используют ли какие-либо самостоятельно размещённые раннеры неподдерживаемые операционные системы или архитектуры либо не вышли ли они за допустимый срок обновления?
- Если стороннее действие завершится сбоем, какой протестированный путь прямого исправления без отката сохранит необходимую контрольную проверку?
10. Где помогает автоматизация
Автоматизация может непрерывно сканировать файлы рабочих процессов и действий, отклонять runs.using: node20, отмечать неодобренные ссылки на действия и сравнивать инвентаризацию со списком разрешённых компонентов. Запланированные проверки могут сообщать версии раннеров и выявлять устаревшие образы самостоятельно размещённых раннеров. Канареечные рабочие процессы могут проверять критически важные действия на одноразовых целевых объектах и сохранять доказательства.
Автоматизация не должна автоматически одобрять новый выпуск стороннего действия. Человек по-прежнему должен проверить владельца действия, примечания к выпуску, разрешения, изменения поведения и достаточность результатов канареечной проверки.
Контрольный список перед слиянием
- [ ] Проведена инвентаризация всех рабочих процессов, повторно используемых рабочих процессов, составных и локальных действий.
- [ ] Для каждого выбранного выпуска JavaScript-действия есть доказательство поддержки Node 24.
- [ ] Внешние действия закреплены в соответствии с политикой безопасности репозитория.
- [ ] Сборочные пакеты локальных действий повторно собраны и протестированы после изменения метаданных.
- [ ] Каждый поддерживаемый класс раннеров успешно прошёл соответствующую канареечную проверку.
- [ ] Побочные эффекты подтверждены обратной проверкой, а не только кодами завершения.
- [ ] Проверены обновления, ОС, архитектура и журналы самостоятельно размещённых раннеров.
- [ ] Контролируемые сценарии сбоев создали ожидаемые доказательства и оповещения.
- [ ] Документированы ответственный за прямое исправление без отката и соответствующая процедура.
Заключение
Прекращение поддержки среды выполнения — это изменение самой системы тестирования и поставки. Наиболее безопасная миграция сочетает точную инвентаризацию зависимостей, актуальные подтверждения поставщика, канареечной проверки на основе рисков, проверку реальных побочных эффектов и явный путь прямого исправления без отката. Успешные тесты важны, но только протестированный конвейер может подтвердить, что эти результаты были надёжно получены, сохранены и доставлены.
Оставить комментарий
Поделитесь своим мнением о статье. Регистрация не требуется.
Комментарии
Загрузка комментариев…