Перейти до вмісту
Relidocs: Reliverse Docs

Environment variables

Змінні оточення відіграють важливу роль в управлінні конфігураційними параметрами вашого додатку, дозволяючи вам налаштувати поведінку вашого проекту без модифікації кодової бази.

Що таке змінні оточення?

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

Загальні типи використання

  • Автентифікація:** Зберігання секретів, таких як ключі API або токени OAuth.
  • Конфігурація:** Визначення специфічних для середовища параметрів, таких як URL-адреси баз даних.
  • Налагодження:** Увімкнення або вимкнення режимів налагодження.

Налаштування змінних середовища

У локальному середовищі розробки

  1. Створіть файл .env у корені вашого проекту.
  2. Додайте пари ключ-значення у форматі KEY=VALUE. Приклад:
DATABASE_URL=postgres://user:password@localhost:5432/mydb
API_KEY=ваш-api-ключ-тут

Примітка: Переконайтеся, що ваш файл .env включено до .gitignore, щоб уникнути фіксації конфіденційної інформації у вашій системі контролю версій.

У виробничому середовищі

Змінні середовища можна встановити за допомогою панелі інструментів вашого хостинг-провайдера, інструментів командного рядка або конвеєрів CI/CD. Зверніться до документації вашої конкретної платформи для отримання точних інструкцій. Приклад для Linux:

Terminal window
export DATABASE_URL=postgres://user:password@prod:5432/mydb

Доступ до змінних оточення

У Node.js

Доступ до змінних оточення можна отримати за допомогою process.env. Приклад:

const dbUrl = process.env.DATABASE_URL;
console.log(`Підключення до бази даних за адресою ${dbUrl}`);

В інших фреймворках

Більшість сучасних фреймворків надають вбудовану підтримку для керування змінними оточення. Зверніться до документації вашого фреймворку за найкращими практиками.

Найкращі практики

  1. Не кодуйте конфіденційну інформацію. Завжди використовуйте змінні оточення для секретів та ключів.
  2. Використовуйте описові ключі. Вибирайте змістовні імена, які передають їх призначення (наприклад, API_KEY, DATABASE_URL).
  3. **Впорядковуйте змінні оточення: групуйте їх логічно, особливо у великих проектах.
  4. Перевіряйте змінні середовища. Переконайтеся, що встановлені необхідні змінні, і надайте значення за замовчуванням, де це можливо. Приклад:
if (!process.env.DATABASE_URL) {
  throw new Error(«DATABASE_URL не задано.»);
}

Додаткова інформація

  • Дізнайтеся більше про посилання у фреймворку Diátaxis.
  • Ознайомтеся з 12-factor app principles для отримання рекомендацій щодо керування змінними оточення.