Конфигурация приложений Go: библиотека viper

Что такое viper и зачем он нужен?

Viper — это мощная библиотека для управления конфигурацией в приложениях на Go (Golang). Она решает одну из ключевых задач разработки: централизованное и гибкое управление настройками приложения, независимо от источника данных. Viper поддерживает работу с JSON, TOML, YAML, HCL, INI, envfile и переменными окружения, что делает его идеальным выбором для микросервисов, CLI-утилит и веб-приложений.

Основные возможности

• Множество источников: чтение из файлов (JSON, YAML, TOML), переменных окружения, удаленных хранилищ (etcd, Consul) и даже флагов командной строки.
• Приоритеты: автоматическое разрешение конфликтов — последний установленный источник имеет высший приоритет.
• Live-перезагрузка: возможность отслеживать изменения в конфигурационных файлах без перезапуска приложения (требует дополнительной настройки).
• Поддержка вложенных ключей: доступ к настройкам через точечную нотацию (например, app.db.host).

Установка

Установите viper через стандартный менеджер пакетов Go:

go get github.com/spf13/viper

Пример кода на Go

Создайте файл config.yaml:

app:
  name: "MyApp"
  port: 8080
database:
  host: "localhost"
  user: "admin"
  password: "secret"

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

package main

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

func main() {
	viper.SetConfigName("config")
	viper.SetConfigType("yaml")
	viper.AddConfigPath(".")

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

	appName := viper.GetString("app.name")
	port := viper.GetInt("app.port")
	dbHost := viper.GetString("database.host")

	fmt.Printf("App: %s, Port: %d, DB: %s\n", appName, port, dbHost)
}

Также можно использовать переменные окружения с префиксом:

viper.SetEnvPrefix("MYAPP")
viper.AutomaticEnv()
// Теперь переменная MYAPP_APP_PORT будет доступна как app.port

Когда использовать viper?

• Когда требуется поддержка нескольких форматов конфигурации (YAML, JSON, TOML).
• Для приложений, где настройки могут переопределяться переменными окружения (например, в Docker/Kubernetes).
• В микросервисной архитектуре, где конфигурация может загружаться из внешних сервисов (etcd, Consul).
• Если нужно разделить конфигурацию на dev/staging/production окружения.

Viper — де-факто стандарт для управления конфигурацией в Go-сообществе, используемый в таких проектах, как Hugo, Docker CLI и многих других.