Static vs Dynamic Secrets

The static secrets submode (part of secrets mode) allows to handle simpler needs where you only want to fetch secrets that are not meant to change over your workload's lifetime. Such secrets may be database credentials (depending on your credentials rotation policy of course) or any confidential data static by nature.

A dedicated annotation, ovai.asaintsever.org/secrets-type, is supported to explicitly define what kind of secrets you intend to fetch, default being dynamic secrets.

When static secrets are set, Open Vault Agent Injector will only inject an init container in your workload's pod. Fetched secrets will be stored in a file in a shared memory volume, the same way it is already done for dynamic secrets. As a result, if you do not enable other modes (e.g. proxy) no sidecar will be added (Note that enabling job mode with static secrets will not incur any sidecar injection either). It also means that you don't have to leverage hooks or wait for the injected Vault Agent to fetch your secrets: your workload can access the values right after its container is started. The drawback of course is that your secrets will not be automatically refreshed upon changes, opt for dynamic secrets if this behavior is required.

If you enable several modes, you may end up with both init container and sidecar(s) in your workload. A comprehensive table is provided in the main documention in section Modes and Injection Config Overview.

New samples are available to quickly demonstrate how to benefit from this feature: