Graduate Ready Pods in Job status to Beta

Author: alculquicondor

keps/prod-readiness/sig-apps/2879.yaml

@@ -1,3 +1,5 @@
 kep-number: 2879
 alpha:
   approver: "@wojtek-t"
+beta:
+  approver: "@wojtek-t"

keps/sig-apps/2879-ready-pods-job-status/README.md

@@ -35,7 +35,7 @@
 
 Items marked with (R) are required *prior to targeting to a milestone / release*.
 
-- [ ] (R) Enhancement issue in release milestone, which links to KEP dir in [kubernetes/enhancements] (not the initial KEP PR)
+- [x] (R) Enhancement issue in release milestone, which links to KEP dir in [kubernetes/enhancements] (not the initial KEP PR)
 - [x] (R) KEP approvers have approved the KEP status as `implementable`
 - [x] (R) Design details are appropriately documented
 - [ ] (R) Test plan is in place, giving consideration to SIG Architecture and SIG Testing input (including test refactors)
@@ -47,7 +47,7 @@ Items marked with (R) are required *prior to targeting to a milestone / release*
 - [x] (R) Production readiness review completed
 - [x] (R) Production readiness review approved
 - [ ] "Implementation History" section is up-to-date for milestone
-- [ ] User-facing documentation has been created in [kubernetes/website], for publication to [kubernetes.io]
+- [x] User-facing documentation has been created in [kubernetes/website], for publication to [kubernetes.io]
 - [ ] Supporting documentation—e.g., additional design documents, links to mailing list discussions/SIG meetings, relevant PRs/issues, release notes
 
 [kubernetes.io]: https://kubernetes.io/
@@ -95,9 +95,9 @@ field based on the number of Pods that have the `Ready` condition.
 ### Risks and Mitigations
 
 - An increase in Job status updates. To mitigate this, the job controller holds
-  the Pod updates that happen in X ms before syncing a Job. X will be determined
-  from experiments on integration tests, but we expect it to be between 500ms
-  and 1s.
+  the Pod updates that happen in X ms before syncing a Job.
+  From experiments using integration tests, X=500ms was found to be a reasonable
+  value.
 
 ## Design Details
 
@@ -107,7 +107,7 @@ field based on the number of Pods that have the `Ready` condition.
 type JobStatus struct {
 	...
 	Active    int32
-	Ready     int32  // new field
+	Ready     *int32  // new field
 	Succeeded int32
 	Failed    int32
 }
@@ -131,12 +131,17 @@ pods that have the `Ready` condition.
 #### Alpha
 
 - Feature gate disabled by default.
-- Unit and integration tests passing.
+- Unit and [integration] tests passing.
+
+[integration]: https://testgrid.k8s.io/conformance-all#Conformance%20-%20GCE%20-%20master&include-filter-by-regex=sig-apps&include-filter-by-regex=Job&exclude-filter-by-regex=CronJob
 
 #### Beta
 
 - Feature gate enabled by default.
-- Existing E2E and conformance tests passing.
+- Existing [E2E] and [conformance] tests passing.
+
+[E2E]: https://testgrid.k8s.io/sig-apps#gce&include-filter-by-regex=apps%5C%5D%20Job
+[Conformance]: https://testgrid.k8s.io/conformance-all#Conformance%20-%20GCE%20-%20master&include-filter-by-regex=sig-apps&include-filter-by-regex=Job&exclude-filter-by-regex=CronJob
 
 #### GA
 
@@ -191,7 +196,7 @@ The Job controller will start populating the field again.
 
 ###### Are there any tests for feature enablement/disablement?
 
-Yes, there will be tests at unit and integration level.
+Yes, there are tests at unit and [integration] level.
 
 ### Rollout, Upgrade and Rollback Planning
 
@@ -301,7 +306,8 @@ No change from existing behavior of the Job controller.
 
 ## Implementation History
 
-- 2021-08-19: Proposed KEP starting in beta status.
+- 2021-08-19: Proposed KEP starting in alpha status, including full PRR questionnaire.
+- 2022-01-05: Proposed graduation to beta.
 
 ## Drawbacks
 

keps/sig-apps/2879-ready-pods-job-status/kep.yaml

@@ -15,14 +15,13 @@ approvers:
 see-also:
 replaces:
 
-stage: alpha
+stage: beta
 
-latest-milestone: "v1.23"
+latest-milestone: "v1.24"
 
 milestone:
   alpha: "v1.23"
   beta: "v1.24"
-  stable: "v1.25"
 
 feature-gates:
   - name: JobReadyPods