Configuração de aplicações Go (Golang): bibliotecas e ferramentas

Configuração de aplicações Go (Golang): bibliotecas e ferramentas

A configuração é um dos aspectos-chave do desenvolvimento de aplicações modernas em Go. Flexibilidade, segurança e simplicidade no gerenciamento de configurações impactam diretamente a estabilidade e escalabilidade do serviço. No ecossistema Golang, existem várias bibliotecas maduras que resolvem as tarefas de carregar configurações de arquivos (JSON, YAML, TOML), variáveis de ambiente, flags de linha de comando e fontes remotas. Neste artigo, examinaremos quatro das ferramentas mais populares: viper, envconfig, koanf e cleanenv, bem como abordagens básicas para gerenciamento de configurações.

Por que é necessária uma biblioteca separada para configuração?

A biblioteca padrão do Go fornece o pacote flag para análise de argumentos de linha de comando e os.Getenv para leitura de variáveis de ambiente. No entanto, em projetos reais, é necessário:

• Suporte a vários formatos de arquivo (JSON, YAML, TOML, HCL).
• Leitura de várias fontes com prioridades (arquivo → variáveis de ambiente → flags).
• Mapeamento automático dos campos da estrutura para as chaves de configuração.
• Validação de campos obrigatórios e tipos.
• Hot-reload (recarregamento da configuração sem reiniciar a aplicação).

As bibliotecas descritas abaixo resolvem todas essas tarefas.

1. Viper — o rei universal da configuração

Viper é a biblioteca de configuração mais popular em Go (mais de 25k estrelas no GitHub). Ela suporta todos os formatos principais, variáveis de ambiente, sistemas remotos (etcd, Consul) e flags de linha de comando.

Instalação

go get github.com/spf13/viper

Exemplo de uso (YAML + variáveis de ambiente)

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")   // nome do arquivo sem extensão    viper.SetConfigType("yaml")     // formato    viper.AddConfigPath(".")        // caminho de busca    viper.AutomaticEnv()            // ler automaticamente variáveis de ambiente

    if err := viper.ReadInConfig(); err != nil {        log.Fatalf("Erro ao ler configuração: %v", err)    }

    var cfg Config    if err := viper.Unmarshal(&cfg); err != nil {        log.Fatalf("Erro ao analisar: %v", err)    }

    fmt.Printf("Porta: %d, DB Host: %s, Debug: %t", cfg.Port, cfg.DBHost, cfg.Debug)}

Características:

• Suporte a chaves aninhadas através de viper.GetString("app.database.host").
• Prioridade: chamada explícita a Set → flag → env → arquivo de configuração → padrão.
• Possibilidade de recarregamento ao vivo através de viper.WatchConfig().

2. envconfig — minimalismo para aplicações 12-factor

Se sua aplicação segue a metodologia 12-factor app e usa apenas variáveis de ambiente, envconfig é a escolha ideal. Ela preenche automaticamente a estrutura com base nas tags envconfig.

Instalação

go get github.com/kelseyhightower/envconfig

Exemplo

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", cfg)}

Vantagens:

• Mínimo de código — basta declarar a estrutura