Job success/completion policy

[tenzen-y]

Enhancement Description

• One-line enhancement description (can be used as a release note): An API to define when a Job can be declared as succeeded based on the number of succeeded pods.
• Kubernetes Enhancement Proposal: https://github.com/kubernetes/enhancements/tree/master/keps/sig-apps/3998-job-success-completion-policy
• Discussion Link: Job success/completion policy kubernetes#117600
• Primary contact (assignee): @tenzen-y
• Responsible SIGs: sig-apps
• Enhancement target (which target equals to which milestone):
  • Alpha release target (x.y): v1.30
  • Beta release target (x.y): v1.31
  • Stable release target (x.y): v1.33
• Alpha
  • KEP (k/enhancements) update PR(s):
    • KEP-3998: Job success/completion policy #4062
    • KEP-3998: Uptdate JobSuccessPolicy API Name and Validations #4537
  • Code (k/k) update PR(s):
    • Job: Support for the SuccessPolicy kubernetes#123412
    • Job: Use the fake clock in TestTrackJobStatusAndRemoveFinalizers kubernetes#123826
  • Docs (k/website) update PR(s):
    • Add JobSuccessPolicy Doc website#45135
    • KEP-3998: Rephrase JobSuccessPolicy documentations website#45677
• Beta
  • KEP (k/enhancements) update PR(s):
    • KEP-3998: Graduate Job SuccessPolicy to Beta #4702
    • KEP-3998: Update the metrics and condition reason for the Beta graduation #4775
  • Code (k/k) update PR(s):
    • Job: Fix a bug that the SuccessCriteriaMet could be added to the Job with successPolicy regardless of the featureGate enabling kubernetes#125429
    • Job: Add the CompletionsReached reason to the SuccessCriteriaMet condition kubernetes#126074
    • Job: Introduce a new job_suceeded_total metric kubernetes#126075
    • Graduate the JobSuccessPolicy to beta kubernetes#126064
    • Graduate the JobSuccessPolicy to Beta kubernetes#126067
  • Docs (k/website) update PR(s): Update JobSuccessPolicy documentations for the beta graduation website#46970
• Stable
  • KEP (k/enhancements) update PR(s): KEP-3998: Graduate JobSuccessPolicy to GA #5148
  • Code (k/k) update PR(s):
    • KEP-3998: Promote JobSuccessPolicy to Stable kubernetes#130536
    • KEP-3998: Promote JobSuccessPolicy E2E to Conformance kubernetes#130658
  • Docs (k/website) update(s):
    • KEP-3998: Graduate JobSuccessPolicy to Stable website#49807
    • Placeholder for JobSuccessPolicy feature blog website#49998

Please keep this description up to date. This will help the Enhancement Team to track the evolution of the enhancement efficiently.

/sig apps
/wg batch
/assign

[alculquicondor]

@soltysh I'm not sure if this will make it to the enhancements freeze, but would you consider a lead-opted-in?

[soltysh]

@soltysh I'm not sure if this will make it to the enhancements freeze, but would you consider a lead-opted-in?

Sorry, I won't be able to get there before today's freeze

[tenzen-y]

Since many discussions are left, I will try to complete it for the next release cycle (v1.29).
Thanks to everyone!

[dejanzele]

Hey @tenzen-y,

Are you still working on this KEP?

I just finished graduation of the PodReplacementPolicy to Beta and I have capacity to take on additional work if you don't have capacity to work on this KEP.

[tenzen-y]

KEP-3998: Job success/completion policy #4062

I'm working on this now. I will move this forward in the next release cycle (v1.30) since the enhancement freeze for this release (v1.29) came.

#4062 (comment)

[kannon92]

@soltysh since the KEP is being reviewed, did you consider adding this as a feature for sig-apps for 1.30?

[soltysh]

/label lead-opted-in
/milestone v1.30
/stage alpha