23 вересня 2026 року GitHub вилучив Node 20 із раннерів GitHub Actions. Тепер JavaScript-дії виконуються в Node 24, а тимчасова можливість відмовитися від переходу за допомогою ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION більше недоступна. Розробники дій мають випустити версії, у метаданих яких зазначено runs.using: node24; власники робочих процесів мають перейти на сумісні версії.

Це може здаватися звичайним оновленням залежності. Проте для QA це міграція системи доставлення змін. Застосунок може успішно пройти всі модульні тести, тоді як отримання вихідного коду, завантаження звітів, кешування, підписання або розгортання завершиться невдало до чи після їх виконання. Отже, мета ширша, ніж просто «зробити CI зеленим»: потрібно зберегти докази й контрольні механізми, які забезпечує конвеєр.

1. Зафіксуйте підтверджену зміну

Відокремте факти постачальника від власних тестових гіпотез.

GitHub підтвердив:

Не перетворюйте ці факти на вигадані правила, наприклад на постійну мінімальну версію раннера. GitHub із часом змінює вимоги до раннерів. Під час кожної міграції самостійно розміщених раннерів перевіряйте актуальну офіційну документацію та відомості про випуски.

Є ще один неочевидний, але важливий момент: крок оболонки, що виконує node -v, показує версію виконуваного файла Node, доступного через PATH. Він не доводить, яке вбудоване середовище виконувало JavaScript-дію. Відомості про середовище виконання дії потрібно отримувати з її метаданих, діагностики раннера, анотацій або діагностичного коду всередині самої дії.

2. Визначте реальну область впливу

Почніть з інвентаризації всього репозиторію, а не чекайте на падіння завдань.

Перевірте:

  1. Усі посилання uses: у файлах .github/workflows/*.yml і .yaml.
  2. Локальні дії в каталогах на кшталт .github/actions/.
  3. Повторно використовувані робочі процеси, що викликаються через workflow_call.
  4. Композитні дії та всі JavaScript-дії, які вони викликають.
  5. Дії, що використовуються лише в робочих процесах випуску, запуску за розкладом або вручну.
  6. Мітки, операційні системи, архітектури та політику оновлення самостійно розміщених раннерів.

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

Для кожної дії, на яку посилається робочий процес:

Не намагайтеся «виправити» міграцію, перемкнувши всі дії на @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 днів після нового випуску, а через критичні оновлення безпеки GitHub може припинити додавання завдань до черги, доки оновлення не буде встановлено.

Тому тестування раннера має охоплювати:

Під час міграції на Node 24 окремо визначте хости з macOS 13.4 або старішою версією та ARM32. Безпечний варіант — оновити їх або перенести завдання на підтримуваний раннер, а не намагатися повернути вилучений механізм обходу для Node 20.

8. Перевірте оброблення відмов і відновлення

Не створюйте негативний тест, який навмисно запускає застарілу продукційну залежність. Натомість додайте в канарковий тест контрольовані відмови:

Перевірте статус, повідомлення про помилку, збережені докази, очищення, політику повторних спроб і сповіщення.

Після вилучення Node 20 підхід «відкотитися до дії на Node 20» не є надійним планом відновлення. Потрібне виправлення в актуальній версії (forward fix): перейдіть на сумісний випуск, виправте й протестуйте контрольований форк або тимчасово замініть проблемний крок підтримуваною реалізацією. Для кожного тимчасового форка зафіксуйте відповідального за рішення та строк припинення його використання.

9. П’ять запитань, які має поставити кожен рецензент

  1. Які робочі процеси й локальні дії фактично інвентаризовано, зокрема процеси за розкладом і повторно використовувані процеси?
  2. Які докази підтверджують, що кожен вибраний випуск дії підтримує Node 24?
  3. Який результат підтверджує фактичну зміну, виконану дією, а не лише її код завершення?
  4. Чи є серед самостійно розміщених раннерів такі, що використовують непідтримувані операційні системи або архітектури чи не були вчасно оновлені?
  5. Якщо стороння дія завершиться невдало, який перевірений шлях виправлення в актуальній версії збереже потрібний контрольний механізм?

10. Де допомагає автоматизація

Автоматизація може постійно сканувати файли робочих процесів і дій, відхиляти runs.using: node20, позначати несхвалені посилання на дії та порівнювати інвентарний список зі списком дозволених залежностей. Перевірки за розкладом можуть повідомляти про версії раннерів і застарілі образи самостійно розміщених раннерів. Канаркові робочі процеси можуть перевіряти критично важливі дії на одноразових цільових ресурсах і зберігати докази.

Автоматизація не повинна автоматично схвалювати новий випуск сторонньої дії. Людина все одно має оцінити, хто супроводжує проєкт, а також примітки до випуску, дозволи, зміни в поведінці та достатність результатів канаркового тесту.

Перелік перевірок перед злиттям

Висновок

Виведення середовища виконання з експлуатації — це зміна самої системи тестування й доставлення. Найбезпечніша міграція поєднує точну інвентаризацію залежностей, актуальні докази від постачальника, канаркові тести з урахуванням ризиків, перевірку фактичних змін і чіткий шлях виправлення в актуальній версії. Успішні тести важливі, але лише перевірений конвеєр може підтвердити, що ці успішні результати надійно отримано, збережено й доставлено.

Джерела