Skip to content

doc: add encrypted-volumes.md feature document - #6506

Open
nixpanic wants to merge 3 commits into
ceph:develfrom
nixpanic:doc/feature/encryption
Open

doc: add encrypted-volumes.md feature document#6506
nixpanic wants to merge 3 commits into
ceph:develfrom
nixpanic:doc/feature/encryption

Conversation

@nixpanic

Copy link
Copy Markdown
Member

Move the encryption sections (life-cycle, LUKS configuration,
metadata KMS, Vault, Amazon KMS/STS, Azure Key Vault, KMIP) out
of docs/rbd/deploy.md into a new top-level feature document
docs/encrypted-volumes.md so it can be referenced independently
of the RBD deployment guide.

Add a dedicated 'CephFS volume encryption' section to
docs/encrypted-volumes.md covering:

  • how to enable fscrypt encryption via the StorageClass
  • which KMS backends are compatible (raw-passphrase only)
  • the volume layout (/.fscrypt and /ceph-csi-encrypted)
  • kernel and Ceph client prerequisites

Replace the sparse 'CephFS Volume Encryption' section in
docs/cephfs/deploy.md with a short summary and a link to the
new section, consistent with the existing RBD pattern.

Move the encryption sections (life-cycle, LUKS configuration,
metadata KMS, Vault, Amazon KMS/STS, Azure Key Vault, KMIP) out
of docs/rbd/deploy.md into a new top-level feature document
docs/encrypted-volumes.md so it can be referenced independently
of the RBD deployment guide.

Replace the removed sections in docs/rbd/deploy.md with a short
summary and a link to the new document.

Register the new page in mkdocs.yml under Features and add a
Design proposals section at the bottom of the new document that
links to all relevant design proposal files:
encrypted-pvc.md, encryption-with-vault-tokens.md,
encryption-with-vault-sa.md, encryption-with-azure-keyvault.md,
encryption-with-keyprotect.md and encryption-with-gklm.md.

Assisted-by: AskBob <askbob@ibm.com>
Signed-off-by: Niels de Vos <ndevos@ibm.com>
Add a dedicated 'CephFS volume encryption' section to
docs/encrypted-volumes.md covering:

* how to enable fscrypt encryption via the StorageClass
* which KMS backends are compatible (raw-passphrase only)
* the volume layout (/.fscrypt and /ceph-csi-encrypted)
* kernel and Ceph client prerequisites

Replace the sparse 'CephFS Volume Encryption' section in
docs/cephfs/deploy.md with a short summary and a link to the
new section, consistent with the existing RBD pattern.

Add cephfs-fscrypt.md and rbd-pv-key-rotation.md to the Design
proposals table in docs/encrypted-volumes.md.

Assisted-by: AskBob <askbob@ibm.com>
Signed-off-by: Niels de Vos <ndevos@ibm.com>
Use docs/assets/favicon.ico as the site favicon so it is
displayed in browser tabs when viewing the MkDocs site.

Assisted-by: AskBob <askbob@ibm.com>
Signed-off-by: Niels de Vos <ndevos@ibm.com>
@nixpanic
nixpanic requested review from a team as code owners August 26, 2026 15:08
Copilot AI lite review requested due to automatic review settings August 26, 2026 15:08
@mergify mergify Bot added ci/skip/e2e skip running e2e CI jobs ci/skip/multi-arch-build skip building on multiple architectures component/docs Issues and PRs related to documentation labels Aug 26, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci/skip/e2e skip running e2e CI jobs ci/skip/multi-arch-build skip building on multiple architectures component/docs Issues and PRs related to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants