Технологічна галузь

GitHub Actions відмовився від Node.js 20: Як перевірити та виправити ваші робочі процеси

GitHub Actions Dropped Node.js 20: How to Audit and Fix Your Workflows

GitHub Actions більше не надає середовище виконання Node.js 20 для дій JavaScript. Навіть якщо ваше застосування не використовує Node.js, старий checkout, setup або стороння дія тепер можуть стати проблемою CI. Ось як перевірити ваші робочі процеси, оновити власні дії та безпечно перевірити самохостингові ранери.

GitHub Actions відмовився від Node.js 20: як аудитувати та виправити ваші робочі потіки

Робочий потік 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 почав перемикати дії на 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.

Якщо ваша організація використовує саморозміщені раненери, включіть їхні версії, операційні системи та архітектури до аудиту міграції замість того, щоб дивитися лише на YAML робочого потьку. Старі операційні системи можуть стати прихованою перешкодою, оскільки Node 24 змінює базовий рівень підтримуваних платформ.

CodeQL має власний шлях міграції

Репозиторії, які використовують сканування коду GitHub, повинні також перевірити свій робочий потік CodeQL. Дія CodeQL 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 як підтримувану інфраструктуру додатків, а не конфігурацію, яку можна написати один раз і забути.

Репозиторій, який періодично аудитує свої дії, версії раненерів, права доступу та сторонні залежності, буде набагато краще підготовленим до наступного переходу середовища і набагато безпечнішим між міграціями.