Skip to content

Commit 375896f

Browse files
committed
Add a note about filesystem overhead for PVC size request
Though this is not explicitly stated, it seems acceptable that once a provider builds a filesystem on top of a block device, some writeable capacity is lost: container-storage-interface/spec#338 Signed-off-by: Alex Kalenyuk <[email protected]>
1 parent df43e5c commit 375896f

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

content/en/docs/concepts/storage/persistent-volumes.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -830,6 +830,11 @@ the request is for storage. The same
830830
[resource model](https://git.k8s.io/design-proposals-archive/scheduling/resources.md)
831831
applies to both volumes and claims.
832832

833+
{{< note >}}
834+
For `Filesystem` volumes, the storage request refers to the "outer" volume size (i.e. the allocated size from the storage backend).
835+
This means that the writeable size may be slightly lower for providers that build a filesystem on top of a block device, due to filesystem overhead. This is especially visible with XFS, where many metadata features are enabled by default.
836+
{{< /note >}}
837+
833838
### Selector
834839

835840
Claims can specify a

0 commit comments

Comments
 (0)