Skip to content

Commit 97899e0

Browse files
committed
update LocalStorageCapacityIsolationFSQuotaMonitoring to beta
Signed-off-by: PannagaRamamanohara <[email protected]>
1 parent 6786d24 commit 97899e0

File tree

2 files changed

+28
-10
lines changed

2 files changed

+28
-10
lines changed

content/en/docs/concepts/configuration/manage-resources-containers.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -463,7 +463,7 @@ that file but the kubelet does not categorize the space as in use.
463463
{{% /tab %}}
464464
{{% tab name="Filesystem project quota" %}}
465465

466-
{{< feature-state for_k8s_version="v1.15" state="alpha" >}}
466+
{{< feature-state feature_gate_name="LocalStorageCapacityIsolationFSQuotaMonitoring" >}}
467467

468468
Project quotas are an operating-system level feature for managing
469469
storage use on filesystems. With Kubernetes, you can enable project
@@ -489,13 +489,21 @@ If a file is created and deleted, but has an open file descriptor,
489489
it continues to consume space. Quota tracking records that space accurately
490490
whereas directory scans overlook the storage used by deleted files.
491491

492+
To use quotas to track a pod's resource usage, the pod must be in
493+
a user namespace. Within user namespaces, the kernel restricts changes
494+
to projectIDs on the filesystem, ensuring the reliability of storage
495+
metrics calculated by quotas.
496+
492497
If you want to use project quotas, you should:
493498

494499
* Enable the `LocalStorageCapacityIsolationFSQuotaMonitoring=true`
495500
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
496501
using the `featureGates` field in the
497-
[kubelet configuration](/docs/reference/config-api/kubelet-config.v1beta1/)
498-
or the `--feature-gates` command line flag.
502+
[kubelet configuration](/docs/reference/config-api/kubelet-config.v1beta1/).
503+
504+
* Ensure the `UserNamespacesSupport`
505+
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
506+
is enabled, and that the kernel, CRI implementation and OCI runtime support user namespaces.
499507

500508
* Ensure that the root filesystem (or optional runtime filesystem)
501509
has project quotas enabled. All XFS filesystems support project quotas.
@@ -511,6 +519,13 @@ If you want to use project quotas, you should:
511519
mounted with project quotas enabled. For both XFS and ext4fs, the
512520
mount option is named `prjquota`.
513521

522+
523+
If you don't want to use project quotas, you should:
524+
525+
* Disable the `LocalStorageCapacityIsolationFSQuotaMonitoring`
526+
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
527+
using the `featureGates` field in the
528+
[kubelet configuration](/docs/reference/config-api/kubelet-config.v1beta1/).
514529
{{% /tab %}}
515530
{{< /tabs >}}
516531

content/en/docs/reference/command-line-tools-reference/feature-gates/local-storage-capacity-isolation-fs-quota-monitoring.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,14 @@ stages:
99
- stage: alpha
1010
defaultValue: false
1111
fromVersion: "1.15"
12+
toVersion: "1.30"
13+
- stage: beta
14+
defaultValue: false
15+
fromVersion: "1.31"
1216
---
13-
When `LocalStorageCapacityIsolation`
14-
is enabled for
15-
[local ephemeral storage](/docs/concepts/configuration/manage-resources-containers/)
16-
and the backing filesystem for [emptyDir volumes](/docs/concepts/storage/volumes/#emptydir)
17-
supports project quotas and they are enabled, use project quotas to monitor
18-
[emptyDir volume](/docs/concepts/storage/volumes/#emptydir) storage consumption rather than
19-
filesystem walk for better performance and accuracy.
17+
When `LocalStorageCapacityIsolation`
18+
is enabled for
19+
[local ephemeral storage](/docs/concepts/configuration/manage-resources-containers/),
20+
the backing filesystem for [emptyDir volumes](/docs/concepts/storage/volumes/#emptydir) supports project quotas,
21+
and `UserNamespacesSupport` is enabled,
22+
project quotas are used to monitor `emptyDir` volume storage consumption rather than using filesystem walk, ensuring better performance and accuracy.

0 commit comments

Comments
 (0)