Merge pull request #4238 from klueska/KEP-4009/Add-CDI-devices-to-device-plugin-API

Update CDI for device plugins KEP for beta graduation

Author: k8s-ci-robot

keps/prod-readiness/sig-node/4009.yaml

@@ -1,3 +1,5 @@
 kep-number: 4009
 alpha:
   approver: "@johnbelamaric"
+beta:
+  approver: "@johnbelamaric"

keps/sig-node/4009-add-cdi-devices-to-device-plugin-api/README.md

@@ -151,6 +151,12 @@ However, these cases will be added in the existing integration tests:
 These cases will be added in the existing `e2e_node` tests:
   - Device Plugin works with CDI devices
 
+Links to tests:
+- TBD: Will fill-in by code freeze
+
+Links to k8s-triage for tests:
+- TBD: Will fill-in by code freeze
+
 ### Graduation Criteria
 
 #### Alpha
@@ -315,11 +321,22 @@ No
 
 ### Troubleshooting
 
+###### How does this feature react if the API server and/or etcd is unavailable?
+
 N/A
 
 ###### What are other known failure modes?
 
-TBD
+The change to Kubernetes to support this feature is very minimal. The CDI
+device list passed from the plugin to the kubelet is opaquely forwarded to the
+underlying container runtime without affecting the overall logic of the kubelet
+in any significant way. As such, the only known failure scenarios result from
+plugins themselves doing something incorrectly (not the kubelet). For example,
+sending back a list of CDI devices that are not included in any CDI spec
+visible to the underlying container runtime. However, such failure scenarios do
+not affect the proper functioning of kubernetes itself, and are therefore out
+of scope for this KEP. We recommend you check the device plugin and container
+runtime logs instead.
 
 ###### What steps should be taken if SLOs are not being met to determine the problem?
 
@@ -328,6 +345,7 @@ N/A
 ## Implementation History
 
 - 2023-05-15: KEP created
+- 2023-09-25: KEP updated to mark transition to beta
 
 ## Drawbacks
 

keps/sig-node/4009-add-cdi-devices-to-device-plugin-api/kep.yaml

@@ -8,6 +8,7 @@ status: implementable
 creation-date: 2023-05-16
 reviewers:
   - swatisehgal
+  - kklues
 approvers:
   - mrunalp
 
@@ -17,12 +18,12 @@ see-also:
 replaces: []
 
 # The target maturity stage in the current dev cycle for this KEP.
-stage: alpha
+stage: beta
 
 # The most recent milestone for which work toward delivery of this KEP has been
 # done. This can be the current (upcoming) milestone, if it is being actively
 # worked on.
-latest-milestone: "v1.28"
+latest-milestone: "v1.29"
 
 # The milestone at which this feature was, or is targeted to be, at each stage.
 milestone: