Skip to content

fix(chart): emit keystore.kms provider so a KMS keystore starts - #50

Merged
khalifaa55 merged 4 commits into
mainfrom
fix/kms-provider
Sep 21, 2026
Merged

khalifaa55 merged 4 commits into
mainfrom
fix/kms-provider

Conversation

@aelmanaa

@aelmanaa aelmanaa commented Sep 20, 2026 •

Copy link
Copy Markdown
Collaborator

This pull request improves and clarifies how the verifier's signing key is managed and configured, especially when using a cloud Key Management Service (KMS) backend. The changes introduce explicit support for selecting a KMS provider (AWS or GCP), update documentation and configuration files for better guidance, and ensure the Helm chart templates and schema enforce these requirements.

Key improvements and clarifications:

KMS Provider Support & Configuration:

  • Added a required provider field under verifier.secrets.bootstrap.kms to specify the cloud KMS provider (aws or gcp) when keystoreBackend is set to kms, with corresponding updates in values.yaml, the schema, and the Helm template logic. [1] [2] [3]

Documentation Updates:

  • Expanded the runbook (RUNBOOK.md) with a new section on the keystore backend, including configuration examples for both Postgres and KMS, and clear instructions for different secret management strategies.
  • Updated both the rendered and template Helm chart documentation (README.md and README.md.gotmpl) to explain how to configure the KMS backend and reference further documentation for production deployments. [1] [2]
  • Improved descriptions in the Helm chart values table for KMS-related fields, specifying required formats, usage, and links to per-cloud IAM guidance.

Template Logic Improvements:

  • Enhanced the Helm template for the verifier's externalsecret.yaml to require and inject the KMS provider field, and to only include the ed25519_key_id if it is provided.

These changes make the configuration for cloud KMS-backed signing keys more robust, explicit, and easier to understand for both development and production deployments.

@aelmanaa
aelmanaa requested review from a team, Angelin01 and khalifaa55 as code owners September 20, 2026 19:48
@github-actions

Copy link
Copy Markdown
Contributor

👋 aelmanaa, thanks for creating this pull request!

To help reviewers, please consider creating future PRs as drafts first. This allows you to self-review and make any final changes before notifying the team.

Once you're ready, you can mark it as "Ready for review" to request feedback. Thanks!

khalifaa55
khalifaa55 previously approved these changes Sep 21, 2026
Comment thread RUNBOOK.md Outdated
Comment thread RUNBOOK.md Outdated
Co-authored-by: Angelo Borsoi Ross <angelo.ross@nethermind.io>
Co-authored-by: Angelo Borsoi Ross <angelo.ross@nethermind.io>
@khalifaa55
khalifaa55 merged commit 72debe7 into main Sep 21, 2026
7 checks passed
@khalifaa55
khalifaa55 deleted the fix/kms-provider branch September 21, 2026 12:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants