Конфигурация приложений Go (Golang)

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

Конфигурация — один из ключевых аспектов разработки современных приложений на Go. Гибкость, безопасность и простота управления настройками напрямую влияют на стабильность и масштабируемость сервиса. В экосистеме Golang существует несколько зрелых библиотек, которые решают задачи загрузки конфигураций из файлов (JSON, YAML, TOML), переменных окружения, флагов командной строки и удалённых источников. В этой статье мы рассмотрим четыре наиболее популярных инструмента: viper, envconfig, koanf и cleanenv, а также базовые подходы к управлению настройками.

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

Стандартная библиотека Go предоставляет пакет flag для парсинга аргументов командной строки и os.Getenv для чтения переменных окружения. Однако в реальных проектах требуется:

Поддержка нескольких форматов файлов (JSON, YAML, TOML, HCL).
Чтение из нескольких источников с приоритетами (файл → переменные окружения → флаги).
Автоматическое маппинг полей структуры на ключи конфигурации.
Валидация обязательных полей и типов.
Hot-reload (перезагрузка конфигурации без перезапуска приложения).

Библиотеки, описанные ниже, решают все эти задачи.

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

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

Установка

go get github.com/spf13/viper

Пример использования (YAML + переменные окружения)

package main

import (
    "fmt"
    "log"
    "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(".")        // путь поиска
    viper.AutomaticEnv()            // автоматически читать переменные окружения

    if err := viper.ReadInConfig(); err != nil {
        log.Fatalf("Ошибка чтения конфигурации: %v", err)
    }

    var cfg Config
    if err := viper.Unmarshal(&cfg); err != nil {
        log.Fatalf("Ошибка разбора: %v", err)
    }

    fmt.Printf("Порт: %d, DB Host: %s, Debug: %t\n", cfg.Port, cfg.DBHost, cfg.Debug)
}

Особенности:

Поддержка вложенных ключей через viper.GetString("app.database.host").
Приоритет: explicit call to Set → flag → env → config file → default.
Возможность live-перезагрузки через viper.WatchConfig().

2. envconfig — минимализм для 12-factor apps

Если ваше приложение следует методологии 12-factor app и использует только переменные окружения, envconfig — идеальный выбор. Она автоматически заполняет структуру на основе тегов envconfig.

Установка

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
    if err := envconfig.Process("myapp", &cfg); err != nil {
        panic(err)
    }
    fmt.Printf("Config: %+v\n", cfg)
}

Преимущества:

Минимум кода — достаточно объявить структуру с тегами.
Поддержка обязательных полей (required:"true") и значений по умолчанию.
Автоматическая документация: envconfig.Usage("myapp", &cfg) выводит список всех переменных.