Конфигурация приложений Go (Golang): библиотеки и инструменты

Конфигурация приложений Go (Golang): обзор библиотек и инструментов

Разработка современных приложений на Go (Golang) требует гибкого и надёжного управления конфигурацией. Настройки могут поступать из переменных окружения, файлов (JSON, YAML, TOML), флагов командной строки или удалённых источников. В этой статье мы рассмотрим ключевые библиотеки и инструменты для конфигурации Go-приложений, их особенности, примеры использования и рекомендации по выбору.

Зачем нужна отдельная библиотека для конфигурации?

Встроенные средства Go (например, пакет os или flag) позволяют читать переменные окружения и флаги, но для сложных проектов этого недостаточно. Сторонние библиотеки предоставляют:

• Поддержку нескольких источников (файлы, env, etcd, Consul).
• Автоматическое связывание полей структуры с конфигурацией.
• Валидацию значений.
• Горячую перезагрузку (watch) изменений.

1. Viper — универсальный король конфигурации

Viper — самая популярная библиотека для конфигурации в Go (более 25k звёзд на GitHub). Она поддерживает YAML, JSON, TOML, HCL, INI, envfile, переменные окружения и удалённые системы (etcd, Consul).

Установка

go get github.com/spf13/viper

Пример использования

package main

import (
    "fmt"
    "github.com/spf13/viper"
)

type Config struct {
    Port    int    `mapstructure:"port"`
    DBHost  string `mapstructure:"db_host"`
    Debug   bool   `mapstructure:"debug"`
}

func main() {
    viper.SetConfigName("config") // имя файла без расширения
    viper.SetConfigType("yaml")
    viper.AddConfigPath(".")

    if err := viper.ReadInConfig(); err != nil {
        panic(fmt.Errorf("ошибка чтения конфига: %w", err))
    }

    var cfg Config
    if err := viper.Unmarshal(&cfg); err != nil {
        panic(fmt.Errorf("ошибка unmarshal: %w", err))
    }

    fmt.Printf("Порт: %d, Хост БД: %s, Отладка: %t\n", cfg.Port, cfg.DBHost, cfg.Debug)
}

Преимущества: огромное сообщество, поддержка множества форматов, возможность переопределения через переменные окружения.

Недостатки: избыточность для простых проектов, сложность в отладке приоритетов источников.

2. envconfig — простота для переменных окружения

Библиотека envconfig (от kelseyhightower) предназначена для чтения конфигурации исключительно из переменных окружения. Минимализм и скорость — её главные козыри.

Установка

go get github.com/kelseyhightower/envconfig

Пример

package main

import (
    "fmt"
    "github.com/kelseyhightower/envconfig"
)

type Config struct {
    Port    int    `envconfig:"PORT" default:"8080"`
    DBHost  string `envconfig:"DB_HOST" required:"true"`
    Debug   bool   `envconfig:"DEBUG"`
}

func main() {
    var cfg Config
    err := envconfig.Process("myapp", &cfg)
    if err != nil {
        panic(err)
    }
    fmt.Printf("Порт: %d, Хост: %s, Debug: %t\n", cfg.Port, cfg.DBHost, cfg.Debug)
}

Переменные окружения будут иметь префикс MYAPP_ (например, MYAPP_PORT).

Плюсы: нулевая зависимость, простота, автоматическая валидация required-полей.

Минусы: только переменные окружения, нет поддержки файлов или флагов.

3. cleanenv — лёгкость и читаемость

Cleanenv (от Ilya Kaznacheev) — ещё один минималистичный инструмент, поддерживающий чтение из env и YAML/JSON файлов. Особенность — встроенная поддержка описаний и хелпа.

Установка

go get github.com/ilyakaznacheev/cleanenv

Пример

package main

import (
    "fmt"
    "github.com/ilyakaznacheev/cleanenv"
)

type Config struct {
    Port int    `yaml:"port" env:"PORT" env-default:"8080"`
    Host string `yaml:"host" env:"HOST" env-required:"true"`
}

func main() {
    var cfg Config
    err := cleanenv.ReadConfig("config.yaml", &cfg)
    if err != nil {
        // fallback на переменные окружения
        err = cleanenv.ReadEnv(&cfg)
    }
    if err != nil {
        panic