From b40df0df0aa8d3b6c4ab14b7a5d1fdbb8f88e3bd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mateusz=20=C5=81oskot?= Date: Wed, 15 Jan 2025 14:48:21 +0100 Subject: [PATCH 1/2] Clarify ReadWriteOnce allows multiple pods to read and write Courrently, description of `ReadWriteOnce` leaves room for misinterpretation of the `access` in "multiple pods to access the volume" bit. This leads to spread of confusing information like multiple pods can access but only one pod can write at a time. See also https://github.com/kubernetes/kubernetes/issues/60903#issuecomment-2592863002 --- content/en/docs/concepts/storage/persistent-volumes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/storage/persistent-volumes.md b/content/en/docs/concepts/storage/persistent-volumes.md index 1a16a0bd9d..576ea6826d 100644 --- a/content/en/docs/concepts/storage/persistent-volumes.md +++ b/content/en/docs/concepts/storage/persistent-volumes.md @@ -632,7 +632,7 @@ The access modes are: `ReadWriteOnce` : the volume can be mounted as read-write by a single node. ReadWriteOnce access - mode still can allow multiple pods to access the volume when the pods are + mode still can allow multiple pods to access, read or write, the volume when the pods are running on the same node. For single pod access, please see ReadWriteOncePod. `ReadOnlyMany` From 26719b93a1a1b19e43a13db970aa11b080032350 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mateusz=20=C5=81oskot?= Date: Thu, 16 Jan 2025 16:58:01 +0100 Subject: [PATCH 2/2] Tweak read/write wording Co-authored-by: Tim Bannister --- content/en/docs/concepts/storage/persistent-volumes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/storage/persistent-volumes.md b/content/en/docs/concepts/storage/persistent-volumes.md index 576ea6826d..76149efed1 100644 --- a/content/en/docs/concepts/storage/persistent-volumes.md +++ b/content/en/docs/concepts/storage/persistent-volumes.md @@ -632,7 +632,7 @@ The access modes are: `ReadWriteOnce` : the volume can be mounted as read-write by a single node. ReadWriteOnce access - mode still can allow multiple pods to access, read or write, the volume when the pods are + mode still can allow multiple pods to access (read from or write to) that volume when the pods are running on the same node. For single pod access, please see ReadWriteOncePod. `ReadOnlyMany`