You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: keps/sig-node/3695-pod-resources-for-dra/README.md
+24-7Lines changed: 24 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -358,7 +358,12 @@ Kubelet may fail to start. The new API may report inconsistent data, or may caus
358
358
359
359
###### Were upgrade and rollback tested? Was the upgrade->downgrade->upgrade path tested?
360
360
361
-
Not Applicable.
361
+
Not Applicable. Because this change:
362
+
363
+
- Is read-only in the kubelet’s in-memory state.
364
+
- Is behind a feature gate, so turning it off simply disables the new endpoints without affecting any existing behavior.
365
+
366
+
In practice, restart the kubelet with the gate disabled (rollback) or re-enabled (upgrade), and the API behavior reverts or returns without loss of data or consistency. Therefore we don’t need a special upgrade/downgrade test matrix for this KEP.
362
367
363
368
###### Is the rollout accompanied by any deprecations and/or removals of features, APIs, fields of API types, flags, etc.?
364
369
@@ -383,7 +388,9 @@ Call the PodResources API and see the result.
383
388
384
389
###### What are the reasonable SLOs (Service Level Objectives) for the enhancement?
385
390
386
-
N/A.
391
+
100% in normal operation. The proposed API exposes in read only mode kubelet internal data, critical for functioning of the kubelet.
392
+
This data has to be available 100% of the time for the proper functioning of the kubelet, thus is expected to be available 100% of time.
393
+
The only possible error source is the API calls being throttled by the rate-limiting introduced with the GA graduation of the parent KEP 606.
387
394
388
395
###### What are the SLIs (Service Level Indicators) an operator can use to determine the health of the service?
389
396
@@ -419,29 +426,35 @@ No.
419
426
420
427
###### Will enabling / using this feature result in increasing size or count of the existing API objects?
421
428
422
-
No.
429
+
No. Enabling this feature does not change the number of API objects returned. But it may increase the size of each object whenever there are Dynamic Resources to report where each ContainerResources now has an extra dynamic_resources field.
423
430
424
431
###### Will enabling / using this feature result in increasing time taken by any operations covered by existing SLIs/SLOs?
425
432
426
433
No. Feature is out of existing any paths in kubelet.
427
434
428
435
###### Will enabling / using this feature result in non-negligible increase of resource usage (CPU, RAM, disk, IO, ...) in any components?
436
+
Negligible amount of CPU and memory. Because the API is purely read-only and piggy-backs on the kubelet’s existing cache and checkpointing machinery, exposing Dynamic Resources incurs only similar minimal serialization and storage as CPUManager and DeviceManager—so any extra CPU, memory, disk, or I/O impact is negligible.
429
437
430
-
DDOSing the API can lead to resource exhaustion.
438
+
###### Can enabling / using this feature result in resource exhaustion of some node resources (PIDs, sockets, inodes, etc.)?
439
+
440
+
No, because the endpoint queries existing data structures inside the kubelet.
431
441
432
442
### Troubleshooting
433
443
434
444
###### How does this feature react if the API server and/or etcd is unavailable?
435
445
436
-
N/A.
446
+
No impact, the feature is node-local.
437
447
438
448
###### What are other known failure modes?
439
449
440
-
The API will always return a well-known error. In normal operation, the API is expected to never return an error and always return a valid response, because it utilizes internal kubelet data which is always available. Bugs may cause the API to return unexpected errors, or to return inconsistent data. Consumers of the API should treat unexpected errors as bugs of this API.
450
+
feature gate disabled: The API will always return a well-known error. In normal operation, the API is expected to never return an error and always return a valid response, because it utilizes internal kubelet data which is always available.
451
+
Bugs may cause the API to return unexpected errors, or to return inconsistent data.
452
+
Consumers of the API should treat unexpected errors as bugs of this API.
441
453
442
454
###### What steps should be taken if SLOs are not being met to determine the problem?
443
455
444
-
N/A.
456
+
Check the error code to learn if the consumer of the API is being throttle by rate limiting introduced in the parent KEP 606.
457
+
Check the kubelet logs to learn about resource allocation errors.
0 commit comments