Configuración de aplicaciones Go (Golang): bibliotecas y herramientas

Configuración de aplicaciones Go (Golang): revisión de bibliotecas y herramientas

El desarrollo de aplicaciones modernas en Go (Golang) requiere una gestión flexible y fiable de la configuración. Los ajustes pueden provenir de variables de entorno, archivos (JSON, YAML, TOML), flags de línea de comandos o fuentes remotas. En este artículo, revisaremos las bibliotecas y herramientas clave para la configuración de aplicaciones Go, sus características, ejemplos de uso y recomendaciones para su elección.

¿Por qué se necesita una biblioteca separada para la configuración?

Las herramientas integradas de Go (por ejemplo, el paquete os o flag) permiten leer variables de entorno y flags, pero para proyectos complejos esto no es suficiente. Las bibliotecas de terceros proporcionan:

• Soporte para múltiples fuentes (archivos, env, etcd, Consul).
• Vinculación automática de campos de estructura con la configuración.
• Validación de valores.
• Recarga en caliente (watch) de cambios.

1. Viper — el rey universal de la configuración

Viper es la biblioteca más popular para configuración en Go (más de 25k estrellas en GitHub). Soporta YAML, JSON, TOML, HCL, INI, envfile, variables de entorno y sistemas remotos (etcd, Consul).

Instalación

go get github.com/spf13/viper

Ejemplo de uso

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") // nombre del archivo sin extensión    viper.SetConfigType("yaml")    viper.AddConfigPath(".")

    if err := viper.ReadInConfig(); err != nil {        panic(fmt.Errorf("error al leer la configuración: %w", err))    }

    var cfg Config    if err := viper.Unmarshal(&cfg); err != nil {        panic(fmt.Errorf("error de unmarshal: %w", err))    }

    fmt.Printf("Puerto: %d, Host BD: %s, Depuración: %t", cfg.Port, cfg.DBHost, cfg.Debug)}

Ventajas: comunidad enorme, soporte de múltiples formatos, posibilidad de sobrescritura mediante variables de entorno.

Desventajas: redundancia para proyectos simples, complejidad en la depuración de prioridades de fuentes.

2. envconfig — simplicidad para variables de entorno

La biblioteca envconfig (de kelseyhightower) está diseñada para leer la configuración exclusivamente de variables de entorno. El minimalismo y la velocidad son sus principales ventajas.

Instalación

go get github.com/kelseyhightower/envconfig

Ejemplo

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("Puerto: %d, Host: %s, Debug: %t", cfg.Port, cfg.DBHost, cfg.Debug)}

Las variables de entorno tendrán el prefijo MYAPP_ (por ejemplo, MYAPP_PORT).

Ventajas: cero dependencias, simplicidad, validación automática de campos required.

Desventajas: solo variables de entorno, no soporta archivos ni flags.

3. cleanenv — ligereza y legibilidad

Cleanenv (de Ilya Kaznacheev) es otra herramienta minimalista que soporta lectura desde env y archivos YAML/JSON. Su característica distintiva es el soporte integrado para descripciones y ayuda.

Instalación

go get github.com/ilyakaznacheev/cleanenv

Ejemplo

package main

import (    "fmt"    "github.com/ilyakaznach