Go Academy · Урок

Значения по умолчанию и отслеживание

Задавайте значения по умолчанию и выполняйте горячую перезагрузку

«Значения по умолчанию и отслеживание» — бесплатный урок Go Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Go Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Go Academy содержит 4 уроков всего.

Разумные значения по умолчанию

Хорошие системы конфигурации работают, даже когда ничего не задано. Значения по умолчанию дают каждому ключу запасное значение, поэтому программа не завершается с ошибкой из-за отсутствующего значения.

Для этого Viper предоставляет SetDefault; этот источник находится в самом низу цепочки приоритетов.

Установка значений по умолчанию

Зарегистрируйте значения по умолчанию до чтения файла. Любой источник — файл, окружение или флаг — переопределяет их.

viper.SetDefault("port", 8080)
viper.SetDefault("logLevel", "info")
fmt.Println(viper.GetInt("port"))

Зачем нужны значения по умолчанию

Значения по умолчанию позволяют уменьшить файлы конфигурации: специалисты по эксплуатации переопределяют только то, что отличается от нормы. Кроме того, они прямо в коде документируют ожидаемую структуру конфигурации.

Горячая перезагрузка с WatchConfig

Иногда требуется, чтобы изменения конфигурации вступали в силу без перезапуска. viper.WatchConfig() отслеживает изменения файла с помощью fsnotify.

viper.WatchConfig()

Реакция на изменения

Зарегистрируйте обратный вызов, который будет выполняться при изменении файла:

viper.OnConfigChange(func(e fsnotify.Event) {
    fmt.Println("config changed:", e.Name)
})
viper.WatchConfig()

Для чего подходит горячая перезагрузка

Горячая перезагрузка особенно полезна для значений, которые безопасно изменять во время работы:

уровень подробности журналирования
флаги функций
ограничения частоты

Избегайте горячей перезагрузки таких параметров, как порт, на котором приложение принимает соединения, или DSN базы данных: обычно для их изменения требуется перезапуск.

Вопрос потокобезопасности

Когда конфигурация может изменяться во время работы, несколько горутин могут одновременно читать её. Функции чтения Viper безопасно вызывать параллельно, но если Вы кэшируете значения в собственных переменных, защищайте их мьютексом или атомарным значением.

var cfg atomic.Value // stores a Config struct
cfg.Store(loadConfig())

Моделирование значений по умолчанию без Viper

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

func intOr(m map[string]int, key string, def int) int {
    if v, ok := m[key]; ok {
        return v
    }
    return def
}

Проверка после перезагрузки

Всегда выполняйте проверку после перезагрузки и до применения изменений. Опечатка в файле должна сохранить старую рабочую конфигурацию, а не привести к сбою работающей службы. Запишите ошибку в журнал и продолжайте обслуживать запросы.

newCfg, err := load()
if err != nil {
    log.Println("bad config, keeping current:", err)
    return
}
current.Store(newCfg)

Имитация перезагрузки

Концептуально перезагрузка повторно считывает источник и заменяет активную конфигурацию. Наблюдатель лишь запускает эту замену при изменении времени модификации файла. В следующем запускаемом примере Вы увидите изменение значения.

Рабочий пример: значения по умолчанию и перезагрузка

Эта автономная программа показывает логику задания значений по умолчанию, а затем имитирует перезагрузку с изменением значения.

package main

import "fmt"

func get(m map[string]int, k string, def int) int {
    if v, ok := m[k]; ok {
        return v
    }
    return def
}

func main() {
    cfg := map[string]int{}
    fmt.Println("port (default):", get(cfg, "port", 8080))
    cfg["port"] = 9090 // simulated reload
    fmt.Println("port (reloaded):", get(cfg, "port", 8080))
}

Быстрая проверка

Проверьте, насколько хорошо Вы поняли значения по умолчанию и отслеживание изменений.

Итоги

Вы узнали о значениях по умолчанию и горячей перезагрузке:

SetDefault предоставляет запасные значения с самым низким приоритетом
WatchConfig вместе с OnConfigChange обеспечивает перезагрузку во время работы
Горячую перезагрузку следует применять только к значениям, безопасным для изменения во время работы
Защищайте кэшированную конфигурацию атомарными операциями или мьютексами и проверяйте её до применения

Часто задаваемые вопросы

Урок «Значения по умолчанию и отслеживание» бесплатный?

Да — полный текст урока «Значения по умолчанию и отслеживание» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Go Academy, подпишись на CoddyKit PRO. Курс Go Academy содержит 4 уроков всего.

Чему я научусь в уроке «Значения по умолчанию и отслеживание»?

Задавайте значения по умолчанию и выполняйте горячую перезагрузку Ты практикуешь Go Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Go Academy?

Предыдущий опыт не требуется. Go Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.

Сколько времени занимает урок «Значения по умолчанию и отслеживание»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Go Academy?

Да. Каждый урок Go Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к Go Academy