Управление конфигурацией в Go — критически важный аспект разработки профессиональных приложений. Правильная организация настроек делает приложение гибким, безопасным и готовым к развертыванию в различных окружениях.

🎯 Почему конфигурация так важна?

В реальных Go проектах конфигурация используется для:

Подключения к базам данных: Строки подключения, пороги соединений
API ключи и секреты: Токены внешних сервисов, пароли
Настройки логирования: Уровни логов, форматы, файлы вывода
Сетевые параметры: Порты сервера, таймауты, URLs сервисов
Бизнес-логика: Feature flags, лимиты пользователей
Мониторинг: Настройки метрик, health checks

🌍 ENV переменные в Go

Environment Variables (переменные окружения) — стандартный способ передачи конфигурации в приложения.

Базовая работа с ENV

Go предоставляет пакет os для работы с переменными окружения:

  • os.Getenv() — получить значение переменной
  • os.Setenv() — установить переменную
  • os.LookupEnv() — проверить существование переменной
  • os.Environ() — получить все переменные

Типичная структура ENV переменных

DATABASE_URL=postgresql://user:pass@localhost/db
REDIS_URL=redis://localhost:6379
API_PORT=8080
LOG_LEVEL=info
JWT_SECRET=your-secret-key
EXTERNAL_API_KEY=abc123

⚙️ Популярные библиотеки для конфигурации

Viper — самая популярная библиотека

github.com/spf13/viper — мощная библиотека для управления конфигурацией:

Возможности Viper:

  • Чтение из JSON, TOML, YAML, HCL, envfile
  • Поддержка ENV переменных с префиксами
  • Значения по умолчанию
  • Живая перезагрузка конфигурации
  • Интеграция с командной строкой (Cobra)

Альтернативы Viper:

godotenv — простая загрузка .env файлов
envconfig — маппинг ENV переменных в структуры
cleanenv — современная библиотека с валидацией
koanf — легковесная альтернатива Viper

🔒 Управление секретами

Секреты — это конфиденциальная информация (пароли, API ключи, токены).

НЕ делайте так:

  • Не храните секреты в коде
  • Не коммитьте секреты в Git
  • Не логируйте секреты
  • Не передавайте секреты через URL

Правильные практики:

  • Используйте ENV переменные
  • Vault для централизованного управления
  • Kubernetes Secrets в k8s кластерах
  • AWS Parameter Store / Azure Key Vault в облаке

🏗️ Архитектура конфигурации

Иерархия источников конфигурации

Обычный порядок приоритета (от высшего к низшему):

  1. Командная строка (флаги)
  2. Переменные окружения
  3. Конфигурационные файлы
  4. Значения по умолчанию

Профили окружения

Типичные окружения в Go проектах:

  • development — локальная разработка
  • testing — автоматические тесты
  • staging — предпродакшн тестирование
  • production — боевое окружение

📝 Форматы конфигурационных файлов

JSON — простой и популярный

{
  "database": {
    "host": "localhost",
    "port": 5432,
    "name": "myapp"
  },
  "server": {
    "port": 8080,
    "timeout": "30s"
  }
}

YAML — читаемый формат

database:
  host: localhost
  port: 5432
  name: myapp
server:
  port: 8080
  timeout: 30s

TOML — конфигурация для Go

[database]
host = "localhost"
port = 5432
name = "myapp"

[server]
port = 8080
timeout = "30s"

🔧 Паттерны организации конфигурации

Централизованная конфигурация

Один объект содержит всю конфигурацию приложения.

Модульная конфигурация

Каждый модуль имеет свою секцию конфигурации.

Typed Configuration

Использование Go структур с тегами для валидации.

Factory Pattern

Создание конфигурационных объектов через фабричные функции.

🧪 Тестирование с конфигурацией

Изоляция тестов

Каждый тест должен иметь изолированную конфигурацию.

Test fixtures

Подготовленные конфигурационные файлы для тестов.

Моки конфигурации

Использование mock объектов для имитации конфигурации.

📊 Мониторинг конфигурации

Config drift detection

Отслеживание изменений конфигурации в runtime.

Валидация конфигурации

Проверка корректности настроек при старте приложения.

Config hot reload

Перезагрузка конфигурации без перезапуска приложения.

🌐 Конфигурация в микросервисах

Service discovery

Автоматическое обнаружение других сервисов.

Centralized configuration

Использование внешних хранилищ конфигурации (Consul, etcd).

Circuit breakers

Настройка паттернов устойчивости через конфигурацию.

☁️ Конфигурация в облачных средах

Docker

Передача ENV переменных в контейнеры через docker-compose или Kubernetes.

Kubernetes

ConfigMaps и Secrets для управления конфигурацией.

Cloud providers

AWS Parameter Store, Azure App Configuration, Google Secret Manager.

📚 Полезные инструменты

direnv — автоматическая загрузка ENV переменных по директории
docker-compose — простое управление ENV для контейнеров
Kubernetes — ConfigMaps и Secrets для кластерных приложений
Vault — централизованное управление секретами
Consul — service discovery и конфигурация

🎓 Рекомендуемая последовательность изучения

  1. Базовый os.Getenv() — освойте встроенные возможности Go
  2. Файлы .env — начните с простых файлов окружения
  3. Viper основы — изучите популярную библиотеку
  4. Структуры конфигурации — организуйте типизированную конфигурацию
  5. Валидация — добавьте проверки корректности настроек
  6. Секреты — изучите безопасное управление чувствительными данными
  7. Профили окружений — настройте разные конфигурации для dev/prod

🔍 Лучшие практики

Безопасность

  • Никогда не логируйте секреты
  • Используйте HTTPS для передачи конфигурации
  • Ограничивайте доступ к конфигурационным файлам

Производительность

  • Кэшируйте конфигурацию в памяти
  • Избегайте частого чтения с диска
  • Используйте lazy loading для больших конфигураций

Maintenance

  • Документируйте все настройки
  • Используйте осмысленные имена переменных
  • Группируйте связанные настройки

🚀 Что дальше?

После освоения управления конфигурацией изучите:

  • Service mesh (Istio, Linkerd) для распределенной конфигурации
  • GitOps подходы для управления конфигурацией
  • Policy as Code для валидации настроек
  • Observability для мониторинга изменений конфигурации

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