Skip to manual
gluon

CLI reference

gluon keys rotate

Rotate a key (new version), the old one still decrypting during the overlap; a secret's new value is read from stdin with --stdin.

Model author or developer

Usage

Run it as gluon keys rotate (in the repository, cargo run -p gluon-cli -- keys rotate).

Console / text
Rotate a key (new version), the old one still decrypting during the overlap; a secret's new value is read from stdin with --stdin

Usage: gluon keys rotate [OPTIONS] <REFERENCE>

Arguments:
  <REFERENCE>  The reference, e.g. vault:entra-client-secret

Options:
      --overlap-hours <OVERLAP_HOURS>  Hours the old version keeps working [default: 24]
      --stdin                          Read the new secret value from stdin (secrets only; keys get new material from the service)
  -h, --help                           Print help

What it reads and writes

It creates a new version of the key or secret; the old version keeps working for --overlap-hours (default 24), so every replica can pick up the new one. A secret's new value is read from stdin with --stdin.

Before you run it

Revoke the old value at its provider only after the overlap has passed.