Знакомство с Viper: конфигурация без боли

У учебного примера одно окружение — ноутбук. У боевого сервиса их минимум три, и разница между ними не в версии бинарника, а в настройках. На dev порт 8080, база локальная, логи болтливые. На staging намерения те же, но стенд общий: порт чаще всего 80, база в докере с другим паролем, логи умеренные. На prod — свой хост базы, настоящий секретный ключ, строгие логи. Бинарник при этом один и тот же: собирать отдельную сборку под каждое окружение — путь к классическому «а на стенде работало». Значит, настройки должны приходить снаружи, в момент запуска. Откуда именно — вопрос стратегии: YAML-файл рядом с бинарником, переменные окружения из systemd или Kubernetes, флаги из командной строки. Правильный ответ почти всегда «всё сразу, с приоритетами»: файл задаёт основу, окружение перекрывает её в деплое, флаг — для разового запуска. Именно это и умеет viper.

У проблемы трёх окружений два плохих решения, и оба встречаются в проде чаще, чем хотелось бы. Первое — константы и переменные пакета: const port = 8080. Меняется настройка — меняется код, пересборка, новый релиз ради смены пароля. Секреты при этом живут в git навсегда: удаление коммита не стирает его из истории и из чужих клонов. Второе — флаги на всё: команда запуска превращается в простыню, которую невозможно прочитать, невозможно продублировать между машинами и опасно показать в логе — ps aux увидит пароль в открытом виде. Оба решения не отвечают и на вопрос приоритетов: если порт задан и флагом, и в файле, кто победит? Каждый проект отвечает по-своему — до первого инцидента. Viper делает этот выбор один раз за всех и одинаковый для всех ключей, о чём дальше.

Viper — конфиг-библиотека Стива Франсии, автора Cobra и Hugo: живёт с 2014 года в github.com/spf13/viper и носит порядка 27 тысяч звёзд на GitHub — по данным репозитория на момент написания курса. Идея умещается в одно предложение: все источники настроек сходятся в один реестр, и программа спрашивает значение по строковому ключу, не зная, откуда оно пришло. viper.GetString("database.host") вернёт хост базы независимо от того, задали вы его в YAML, в переменной окружения или флагом. За этим стоит лестница приоритетов, зашитая в библиотеку: явный Set сильнее флага, флаг сильнее окружения, окружение сильнее конфиг-файла, файл сильнее key/value-хранилища, в самом низу — дефолты из SetDefault. Справедливости ради: в курсе Cobra viper появлялся как эпизод — один урок на знакомство. Здесь он главный герой: двадцать пять уроков от первого YAML до production-схемы с валидацией и горячей перезагрузкой.

Весь вход в библиотеку viper — горстка функций над глобальным реестром. SetDefault задаёт значение по умолчанию: viper.SetDefault("server.port", 8080) — и программа без файла всё равно поднимется. SetConfigFile называет конкретный файл конфигурации, ReadInConfig читает и разбирает его в реестр — пара, с которой начинается следующий урок про первый YAML. Get("server.port") возвращает значение как any: универсально, но без типа, поэтому в реальном коде зовут типизированных наследников — GetString, GetInt, GetBool, GetStringSlice, — которые приводят значение к нужному типу сами. Set кладёт значение поверх всех источников: это самый сильный слой, и о нём — предупреждение ниже. Всё остальное API — Unmarshal в структуру, WatchConfig для перезагрузки, BindPFlag для флагов — надстройки над этими пятью вызовами, и каждому найдётся отдельный урок.

Курс ведёт от первого файла до production-схемы, и каждый урок добавляет один слой. Дальше по порядку: первый YAML через SetConfigFile и ReadInConfig, форматы от JSON до TOML — один API для всех, затем типизированные Get, дефолты, окружение и префиксы, связка с флагами Cobra и большая тема приоритетов источников. Во второй половине — Unmarshal в структуры, вложенные ключи, горячая перезагрузка WatchConfig, профили dev/staging/prod и секреты, которые не должны жить в git. Финал — итоговый проект: один бинарник читает файл, перекрывается окружением и флагами, валидирует значения на старте и перечитывает конфиг без перезапуска. Если база Go ещё шатается, начните с базового курса — viper опирается на структуры, ошибки и пакеты.