node: dra: podresources: KEP-3695 Beta in 1.34

document feature gate changes; clarify documentation.

Signed-off-by: Francesco Romani <[email protected]>

Author: ffromani

content/en/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins.md

@@ -270,11 +270,12 @@ the NUMA node where these devices are allocated. Also, for NUMA-based machines,
 information about memory and hugepages reserved for a container.
 
 Starting from Kubernetes v1.27, the `List` endpoint can provide information on resources
-of running pods allocated in `ResourceClaims` by the `DynamicResourceAllocation` API. To enable
-this feature `kubelet` must be started with the following flags:
+of running pods allocated in `ResourceClaims` by the `DynamicResourceAllocation` API.
+Starting from Kubernetes v1.34, this feature is enabled by default.
+To disable, `kubelet` must be started with the following flags:
 
 ```
---feature-gates=DynamicResourceAllocation=true,KubeletPodResourcesDynamicResources=true
+--feature-gates=KubeletPodResourcesDynamicResources=false
 ```
 
 ```gRPC
@@ -414,7 +415,7 @@ will continue working.
 
 ### `Get` gRPC endpoint {#grpc-endpoint-get}
 
-{{< feature-state state="alpha" for_k8s_version="v1.27" >}}
+{{< feature-state state="beta" for_k8s_version="v1.34" >}}
 
 The `Get` endpoint provides information on resources of a running Pod. It exposes information
 similar to those described in the `List` endpoint. The `Get` endpoint requires `PodName`
@@ -428,18 +429,19 @@ message GetPodResourcesRequest {
 }
 ```
 
-To enable this feature, you must start your kubelet services with the following flag:
+To disable this feature, you must start your kubelet services with the following flag:
 
 ```
---feature-gates=KubeletPodResourcesGet=true
+--feature-gates=KubeletPodResourcesGet=false
 ```
 
 The `Get` endpoint can provide Pod information related to dynamic resources
-allocated by the dynamic resource allocation API. To enable this feature, you must
-ensure your kubelet services are started with the following flags:
+allocated by the dynamic resource allocation API.
+Starting from Kubernetes v1.34, this feature is enabled by default.
+To disable, `kubelet` must be started with the following flags:
 
 ```
---feature-gates=KubeletPodResourcesGet=true,DynamicResourceAllocation=true,KubeletPodResourcesDynamicResources=true
+--feature-gates=KubeletPodResourcesDynamicResources=false
 ```
 
 ## Device plugin integration with the Topology Manager

content/en/docs/reference/command-line-tools-reference/feature-gates/KubeletPodResourcesDynamicResources.md

@@ -8,10 +8,13 @@ _build:
 stages:
   - stage: alpha
     defaultValue: false
-    fromVersion: "1.27"  
+    fromVersion: "1.27"
+    toVersion: "1.33"
+  - stage: beta
+    defaultValue: true
+    fromVersion: "1.34"
 ---
-Extend the kubelet's pod resources gRPC endpoint to
-to include resources allocated in `ResourceClaims` via `DynamicResourceAllocation` API.
-See [resource allocation reporting](/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins/#monitoring-device-plugin-resources) for more details.
-with information about the allocatable resources, enabling clients to properly
-track the free compute resources on a node.
+Extend the kubelet's
+[pod resources monitoring gRPC API](/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins.md)
+endpoints List and Get to include resources allocated in ResourceClaims
+via [Dynamic Resource Allocation](/docs/concepts/scheduling-eviction/dynamic-resource-allocation/).

content/en/docs/reference/command-line-tools-reference/feature-gates/KubeletPodResourcesGet.md

@@ -9,6 +9,10 @@ stages:
   - stage: alpha
     defaultValue: false
     fromVersion: "1.27"
+    toVersion: "1.33"
+  - stage: beta
+    defaultValue: true
+    fromVersion: "1.34"
 ---
 Enable the `Get` gRPC endpoint on kubelet's for Pod resources.
 This API augments the [resource allocation reporting](/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins/#monitoring-device-plugin-resources).