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 днів після нового випуску, а через критичні оновлення безпеки GitHub може припинити додавання завдань до черги, доки оновлення не буде встановлено.
Тому тестування раннера має охоплювати:
- актуальну версію застосунку раннера та режим оновлення;
- підтримувані ОС і архітектуру;
- вихідні мережеві з’єднання, потрібні діям;
- чисте робоче середовище або ефемерний життєвий цикл;
- зберігання журналів невдалих і ефемерних завдань;
- контрольовану процедуру заміни образу раннера.
Під час міграції на Node 24 окремо визначте хости з macOS 13.4 або старішою версією та ARM32. Безпечний варіант — оновити їх або перенести завдання на підтримуваний раннер, а не намагатися повернути вилучений механізм обходу для Node 20.
8. Перевірте оброблення відмов і відновлення
Не створюйте негативний тест, який навмисно запускає застарілу продукційну залежність. Натомість додайте в канарковий тест контрольовані відмови:
- неправильне значення обов’язкового вхідного параметра;
- недоступна одноразова кінцева точка;
- пошкоджений тестовий артефакт;
- заборона запису;
- скасоване завдання;
- невдале очищення після виконання дії.
Перевірте статус, повідомлення про помилку, збережені докази, очищення, політику повторних спроб і сповіщення.
Після вилучення Node 20 підхід «відкотитися до дії на Node 20» не є надійним планом відновлення. Потрібне виправлення в актуальній версії (forward fix): перейдіть на сумісний випуск, виправте й протестуйте контрольований форк або тимчасово замініть проблемний крок підтримуваною реалізацією. Для кожного тимчасового форка зафіксуйте відповідального за рішення та строк припинення його використання.
9. П’ять запитань, які має поставити кожен рецензент
- Які робочі процеси й локальні дії фактично інвентаризовано, зокрема процеси за розкладом і повторно використовувані процеси?
- Які докази підтверджують, що кожен вибраний випуск дії підтримує Node 24?
- Який результат підтверджує фактичну зміну, виконану дією, а не лише її код завершення?
- Чи є серед самостійно розміщених раннерів такі, що використовують непідтримувані операційні системи або архітектури чи не були вчасно оновлені?
- Якщо стороння дія завершиться невдало, який перевірений шлях виправлення в актуальній версії збереже потрібний контрольний механізм?
10. Де допомагає автоматизація
Автоматизація може постійно сканувати файли робочих процесів і дій, відхиляти runs.using: node20, позначати несхвалені посилання на дії та порівнювати інвентарний список зі списком дозволених залежностей. Перевірки за розкладом можуть повідомляти про версії раннерів і застарілі образи самостійно розміщених раннерів. Канаркові робочі процеси можуть перевіряти критично важливі дії на одноразових цільових ресурсах і зберігати докази.
Автоматизація не повинна автоматично схвалювати новий випуск сторонньої дії. Людина все одно має оцінити, хто супроводжує проєкт, а також примітки до випуску, дозволи, зміни в поведінці та достатність результатів канаркового тесту.
Перелік перевірок перед злиттям
- [ ] Інвентаризовано всі робочі процеси, повторно використовувані робочі процеси, композитні та локальні дії.
- [ ] Для кожного вибраного випуску JavaScript-дії є докази підтримки Node 24.
- [ ] Зовнішні дії зафіксовано відповідно до політики безпеки репозиторію.
- [ ] Після зміни метаданих пакети локальних дій повторно зібрано й протестовано.
- [ ] Кожен підтримуваний клас раннерів успішно пройшов відповідний канарковий тест.
- [ ] Фактичні зміни перевірено повторним зчитуванням, а не лише за кодами завершення.
- [ ] Перевірено оновлення, ОС, архітектуру та журнали самостійно розміщених раннерів.
- [ ] Сценарії контрольованих відмов створили очікувані докази й сповіщення.
- [ ] Задокументовано відповідального та процедуру виправлення в актуальній версії.
Висновок
Виведення середовища виконання з експлуатації — це зміна самої системи тестування й доставлення. Найбезпечніша міграція поєднує точну інвентаризацію залежностей, актуальні докази від постачальника, канаркові тести з урахуванням ризиків, перевірку фактичних змін і чіткий шлях виправлення в актуальній версії. Успішні тести важливі, але лише перевірений конвеєр може підтвердити, що ці успішні результати надійно отримано, збережено й доставлено.
Залишити коментар
Поділіться думкою про статтю. Реєстрація не потрібна.
Коментарі
Завантаження коментарів…