-
ConfigKit v1.3.0 Stable
released this
2026-11-18 15:26:58 +00:00 | 0 commits to main since this releaseConfigKit v1.3.0
Applications can now bootstrap secrets from a directory declared in a discovered
main configuration file, then load that same captured document. Explicit
overwrite options support deployments that give provisioned secret files
priority over existing environment variables.Configured secrets startup
Call
LoadSecretsIntoEnvironmentFromConfigwith a hostFileorSearchConfig
source. The selected main file can declare:config: secrets_dir: secrets secrets_overwrite: trueThe helper resolves the directory relative to the main file's canonical
directory, within its filesystem root, and bootstraps all eligible entries.
It returns a secrets report and a prepared source. Pass that source toLoad,
or use it as the mainInput.SourceforLoadLayered.The prepared source retains the selected main contents and filesystem context
for reuse. Later loads acquire imports and look up environment values at their
normal lifecycle points.SecretsFromConfigOptions.Filesystemcan select a
wider host root during preparation. An explicit context supplied to a later
load must resolve to the captured context. Startup example · Configuration contractExplicit overwrite policy
Overwrite defaults to false, preserving existing variables including empty
ones. YAMLsecrets_overwrite: trueenables replacement during configured
bootstrap. A non-nilSecretsFromConfigOptions.Overwritetakes precedence over
YAML, including an explicit false.For an application-supplied directory, use
LoadSecretsIntoEnvironmentWithOptionswithSecretsOptions{Overwrite: true}.
ExistingLoadSecretsIntoEnvironment(directory)calls retain their preservation
behavior and exact Go function signature.Bootstrap runs through an explicit helper call before configuration loading.
Reports describe writes, skips, and partial failures without credential contents.
A later configuration failure leaves completed environment writes in place.
OrdinaryLoadandLoadLayeredconsume the main controls and resolve typed
secret references from the environment. Bootstrap and failure handlingConsumers require Go 1.27.0 or later.
Downloads