Как правильно хранить конфигурационные параметры приложения, например URL внешнего сервиса?

Зачем правильно хранить конфигурацию

Конфигурационные параметры — это данные, которые могут меняться в зависимости от окружения: адреса сервисов, порты, ключи доступа, уровни логирования. Если захардкодить их в коде, приложение станет негибким: для каждого окружения придётся пересобирать и передеплоивать код, а секреты окажутся в репозитории, что создаёт угрозу безопасности.

Основные подходы

• Переменные окружения — стандартный способ для 12-factor приложений. Значения задаются в системе, где запускается приложение, и доступны через process.env (Node.js) или аналогичные механизмы в других языках.
• Конфигурационные файлы — например, config.json или .env. Файлы удобны для локальной разработки, но их не следует коммитить в Git, если там есть секреты.
• Внешние сервисы конфигурации — для микросервисов часто используют централизованные хранилища (Consul, Vault, Kubernetes ConfigMaps/Secrets), чтобы управлять настройками динамически.

Пример на Node.js

// .env файл (не в Git)
API_URL=https://api.example.com
API_KEY=secret123

// config.js
require('dotenv').config();

const config = {
  apiUrl: process.env.API_URL,
  apiKey: process.env.API_KEY
};

module.exports = config;

// использование
const config = require('./config');
console.log(config.apiUrl);

Практические рекомендации

• Никогда не храните секреты в коде или в репозитории.
• Используйте разные наборы переменных для dev, staging и production.
• Для локальной разработки применяйте файлы .env, которые добавляются в .gitignore.
• В Docker и Kubernetes используйте встроенные механизмы для передачи переменных окружения.

Вывод

Правильное хранение конфигурации делает приложение переносимым, безопасным и легко настраиваемым. Используйте переменные окружения как основной механизм, а для сложных систем — внешние сервисы конфигурации. Это особенно важно при работе в команде и при развёртывании в облаке.