/go-figgy

Go Package for tagging a struct with metadata for getting configuration values from AWS Parameter Store

Primary LanguageGoApache License 2.0Apache-2.0

go-figgy

GoDoc CircleCI codecov Go Report Card

Why is this a thing?!

We wanted to experiment with AWS's Parameter Store as a centralized system for managing out configurations. Turns out, it is a lot of work loading them and pushing the values into configuration structs to be used by other components.

Our solution was to use Go's awesome tag feature to ease the burden of using the SSM SDK directly. This allows us to define our configuration in the struct itself and populate the struct's fields with values when loaded!

TLDR: Tags are awesome and injecting configuration from AWS into our structs with them is even awesomer!

Install

go get github.com/Syncbak-Git/go-figgy

Getting started

It's as simple as defining a struct, decorating it with tags, and loading it.

type Config struct{
    Server   string `ssm:"/myapp/prod/server"`
    Port     int    `ssm:"/myapp/prod/port"`
    Password string `ssm:"/myapp/prod/password,decrypt"`
}

//... meanwhile, more handwaving
cfg := Config{}
figgy.Load(ssmClient, &cfg)

The Future

Here are some additional features we would like to see in the near future:

  • Support type conversions for map type and slices of structs
  • Pass in load parameters to configure how parameters can be loaded
    • prefix/suffix to always append to parameter keys
  • Allow tags defined on a parent struct to influence the child field tags
    • This is similar to how the xml package handles unmarshaling
  • Allow tags with like pathing to be grouped together to minimize calls