Документація ServBay: Вказівка певної версії Node.js для ваших проектів, скриптів і сайтів

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

У цій статті детально пояснюється, як легко задавати конкретні версії Node.js для скриптів і сайтів у середовищі ServBay, а також як використовувати конфігурації на рівні проекту.

Вказівка версії Node.js та параметрів проєкту у .servbay.config

Для проектів, у яких потрібно чітко контролювати версію Node.js та змінні середовища, ServBay пропонує конфігурацію на рівні проекту — створення файлу .servbay.config у кореневій теці проекту. У цьому файлі ви можете визначити: яку версію Node.js використовувати, кінцеві точки сховищ для пакетних менеджерів, каталоги кешу тощо, щоб ізолювати й стандартизувати середовище розробки проекту.

Приклад файлу .servbay.config, що задає конкретну версію Node.js та параметри npm/yarn і кешування:

NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Приклад: використання певного дзеркала
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Приклад: використання певного дзеркала
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # Приклад: вказуємо каталог кешу
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # Приклад: вказуємо каталог кешу

Пояснення:

• NODE_VERSION: Версія Node.js, яка буде використовуватись у цьому проекті. ServBay знайде й використає встановлену версію, що відповідає зазначеній.
• YARN_CONFIG_REGISTRY, NPM_CONFIG_REGISTRY: Вказує, які кінцеві точки сховищ використовуватимуть npm чи yarn.
• NPM_CONFIG_CACHE, YARN_CONFIG_CACHE: Каталоги для кешування пакетних менеджерів npm чи yarn. У прикладі використовується стандартний тимчасовий каталог ServBay /Applications/ServBay/tmp/.

Файл .servbay.config зазвичай розташовується у корені вашого проекту. Детальніше про структуру й можливості дивіться у офіційній документації ServBay про файл .servbay.config.

Запуск скриптів із конкретною версією Node.js через командний рядок

Якщо вам не потрібні налаштування версії Node.js на рівні проекту, а лише необхідно одноразово виконати скрипт під конкретною версією Node.js, скористайтеся командними псевдонімами від ServBay.

У терміналі ServBay (можна відкрити через інтерфейс додатку) ви можете запускати скрипти із зазначеною версією Node.js, використовуючи команду node-<version>. Для кожної встановленої версії Node.js створюється свій псевдонім.

Наприклад, щоб запустити script.js під Node.js 14:

$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # Приклад виводу, версія може відрізнятись

$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # Приклад виводу, версія може відрізнятись

$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # Приклад виводу, версія може відрізнятись

Пояснення до прикладу

• $ node-14 script.js: Виконує script.js під Node.js 14 (яку саме підверсію буде взято, залежить від вашої інсталяції).
• $ node-16 script.js: Виконує скрипт під Node.js 16.
• $ node-20 script.js: Виконує скрипт під Node.js 20.

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

Вказівка версії Node.js для сайту через інтерфейс ServBay

ServBay дозволяє вибирати версію Node.js для кожного окремого сайту безпосередньо через адміністративний інтерфейс. Це необхідно, якщо сайт використовує Node.js як серверний рушій (наприклад, застосунки на Express.js, Next.js тощо, які розгортаються через зворотне проксі Caddy або Nginx) або просто вимагає спеціального середовища Node.js.

Кроки

1. Відкрийте адміністративний інтерфейс ServBay: Запустіть сервіс ServBay та перейдіть у налаштування в браузері (зазвичай це http://localhost:5200 або посилання з головного вікна додатка).

2. Перейдіть у розділ «Сайти»: На лівій бічній панелі оберіть пункт «Сайти» (Website).

3. Виберіть і відредагуйте сайт: У списку знайдіть ваш сайт (наприклад, створений у /Applications/ServBay/www/servbay.demo). Натисніть на кнопку редагування (зазвичай іконка шестерні або олівця), або перейдіть у подробиці, натиснувши на назву.

4. Встановіть версію Node.js: У налаштуваннях знайдіть випадаючий список для вибору версії Node.js. Оберіть потрібну версію, яку сайт використовуватиме за замовчуванням.

5. Збережіть зміни: Після обрання версії натисніть кнопку «Зберегти» чи «Застосувати» внизу сторінки, щоб закріпити зміни.

6. Перезапустіть сайт або ServBay (за потреби): Деякі зміни можуть вимагати перезапуску відповідного веб-сервера (Caddy, Nginx) чи всього ServBay. Зазвичай інтерфейс попередить, якщо це потрібно для застосування налаштувань.

На що звернути увагу

• Переконайтесь, що обрана версія Node.js встановлена та активна: Обрана у налаштуваннях версія Node.js має бути інстальована й запущена у розділі «Пакети» (Packages) ServBay. Якщо її ще немає — встановіть та активуйте її там.
• Тип сайту: Ця опція актуальна для сайтів, які працюють на Node.js (Express.js, Next.js, NestJS тощо). Для статичних сайтів або проектів повністю на PHP/Python/Go — це налаштування не впливає або майже не впливає.
• Перевірка сумісності: Після зміни версії Node.js протестуйте роботу сайту, щоб переконатися, що всі залежності та служби працюють коректно з новою версією.
• Взаємодія з .servbay.config: Налаштування сайту задає версію за замовчуванням. Якщо у теці сайту ще є файл .servbay.config з параметром NODE_VERSION, то його значення переважатиме, оскільки конфігурація проекту має вищий пріоритет для детального контролю.

Підсумок

ServBay — це універсальне середовище локальної розробки, яке дає змогу гнучко й потужно керувати версіями Node.js для різних сценаріїв використання. Ви можете налаштувати специфічні параметри у .servbay.config на рівні проекту, швидко запускати скрипти під різними версіями Node.js через командний рядок (формат node-<version>), а також задавати версію Node.js для сайту через інтерфейс управління ServBay. Це дозволяє комфортно підтримувати різні проекти, перевіряти нові функції Node.js чи забезпечувати ідентичність середовища розробки та продакшн-системи. Завдяки ServBay ви підвищуєте ефективність роботи й отримуєте цілковитий контроль над конфігурацією свого середовища.