Всем доброго времени суток! Имея за плечами многолетний опыт разработки в Java, а точнее в Spring Framework и начав разрабатывать на языке Go в промышленных масштабах, я стал сталкиваться с такой проблемой, что мне действительно не хватает многих фишек из Spring'a. И одна из этих проблем: указание переменной среды в качестве параметра в конфигурационных yaml-файлах
Для автоматизации деплоя, использования различных правил сборки проблема вставала все острее и острее. Я поисследовал различные модули и библиотеки. Нашел несколько интересных решений в cleanenv и даже в viper, но пришел к выводу: "а почему бы не сделать что-то свое?!" Сказано - сделано.
Проблема
Задача стояла следующим образом: я не знаю какую библиотеку я буду использовать в будущем, может быть напишу свою, может на рынке появится что-то более интересное. Но библиотека должна быть отделимой и работать в любой момент времени при наличии только двух сущностей: структуры и названия переменной в структуре. Можно обойтись просто кодом.
Решение
У нас есть некий конфиг для удобства. Называется local.yaml. Представляет собой простой yaml-файл с набором переменных. Все переменные окружения прописываются через специальные символы ${MY_VAR}. Прямо как в Spring'e!
properties:
host: ${SERVER_HOST}
port: ${SERVER_PORT}
routes:
- name: Host1
target: ${HOST1_TARGET}
- name: Host2
target: ${HOST2_TARGET}Теперь понятно как будут выглядеть структуры
type (
ApiServer struct {
Host string `mapstructure:"host"`
Port string `mapstructure:"port"`
Routes []Route `mapstructure:"routes"`
}
Route struct {
Name string `mapstructure:"name"`
Target string `mapstructure:"target"`
}
)Ну и осталось дело за малым. Проинициализировать структуры нашим файлом конфигураций и прикрепить разработанное расширение. Инициализировать будем viper'ом, но на самом деле это не имеет никакого значения. Приблизительно, не вдаваясь в подробности инициализации viper, это будет выглядеть как-то так
if err := viper.ReadInConfig(); err != nil {
log.Fatalf("could not load configuration: %v", err)
}
viper.AutomaticEnv()
config := &ApiServer{}
if err := viper.UnmarshalKey("properties", config); err != nil {
panic(err)
}Самое главное тут получить проинциализированный config переменную, которая является нашей структурой к которой мы будем прикручивать уже переменные среды. А это, как показывает код очень и очень просто
import (
gobindenv "github.com/dissdoc/go-bindenv"
)
// Инициализируем переменные
gobindenv.BindEnv(config)
// И теперь делаем что хотим
fmt.Println(config.Host, config.Port)О расширении пару слов
Называется данное расширение go-bindenv. Устанавливается на ваш вкус, как хотите, как пример. За собой не тянет дополнительных модулей. Все работает максимально "экологично" ;-)
go get github.com/dissdoc/go-bindenv@v0.1.0Изначально то, что реализовано сейчас - мне хватает более чем. Но если, на ваш взгляд, чего-то недостает, я готов выслушать и реализовать.
Библиотека содержит в себе несколько бизнес-слоев, каждый отвечает за свой функционал, чтобы в дальнейшем было проще расширять.
readenv.go - содержит функционал чтения переменных среды. В случае, если переменная определена в конфиге, но не передано значение - вызывается panic
rule.go - одна из возможных интерпретаций определения переменных. В моем случае я пользуюсь только регулярными выражениями
wrapper.go - рефлексия определяющая в каком типе переменных определено правило и на основе этого инициализирует данную переменную значением
В заключении
Данный функционал мне помогает сократить количество шагов для деплоя, а так же немного поубирать лишний код. С другой стороны, хочется улучшать и расширять функционал данного модуля, но не хочется из него делать очередной швейцарский нож. Надеюсь, что данный модуль будет вам полезен!
P.S. никаких телеграм-каналов, блогов не веду. Делаю все в свое удовольствие. До новых встреч!
UPD: основная задача данного расширения - развязать зависимости кода от конфигурации в части чтения переменных. Теперь, в случае изменения названия переменной - сам код приложения переписывать не нужно
