batch/v1: add suspend field to Jobs API

[adtac]

Enhancement Description

• One-line enhancement description (can be used as a release note): Add a suspend field to the Jobs API to allow orchestrators to create jobs with more control over when pods are created.

• Kubernetes Enhancement Proposal: KEP 2232: add Suspend Job in implementable status #2234

• Discussion Link:

  • Add a suspend/stop flag to job api kubernetes#97170
  • https://docs.google.com/document/d/1uTnjWkcDaEZZnOfbkFvUgfYbPfo3EGFdHfkAqr8E5VQ/edit (see section in Hook 1)

• Primary contact (assignee): @adtac

• Responsible SIGs: sig-apps

• Enhancement target (which target equals to which milestone):

  • Alpha release target (x.y): 1.21
  • Beta release target (x.y): 1.22
  • Stable release target (x.y): 1.24

• Alpha

  • KEP (k/enhancements) update PR(s): KEP 2232: add Suspend Job in implementable status #2234 (merged)
  • Code (k/k) update PR(s): batch API: add suspended job kubernetes#98727 (merged)
  • Docs (k/website) update PR(s): job.md: add section on suspended jobs website#26466 (merged)

• Beta

  • KEP (k/enhancements) update PR(s): suspended jobs: graduate to beta #2646 (merged)
  • Code (k/k) update PR(s): graduate SuspendJob to beta kubernetes#102022 (merged)
  • Docs (k/website) update(s): SuspendJob: graduate to beta website#28881 (merged)

• GA

  • KEP (k/enhancements) update PR(s): KEP-2232: Graduate suspend job to stable #3115 (merged)
  • Code (k/k) update PR(s): Graduate SuspendJob to GA kubernetes#108129 (merged)
  • Docs (k/website) update(s): Promote SuspendJob to GA website#32333 (merged)

/sig apps

[arunmk]

hi @adtac I am one of the enhancement shadows for 1.21 and am reviewing this feature. I did not find graduation criteria for alpha phase in the kep. Could you please let me know if there are any?

[adtac]

We don't have any criteria for alpha -- the feature will be turned off by default and we expect users to test it for the first time in alpha. Feedback from users will be a part of beta graduation, but the criteria for alpha is pretty much just the existence of the KEP.

[arunmk]

Hi @adtac

This KEP looks good and I don't see any thing missing. However I am adding this message for the sake of completeness.

Enhancements Freeze is 2 days away, Feb 9th EOD PST.

Any enhancements that do not complete the following requirements by the freeze will require an exception.

[DONE] The KEP must be merged in an implementable state
[DONE] The KEP must have test plans: needs to be updated in the right section as per template
[DONE] The KEP must have graduation criteria
[DONE] The KEP must have a production readiness review

[arunmk]

Hi @adtac,

Since your Enhancement is scheduled to be in 1.21, please keep in mind the important upcoming dates:

• Tuesday, March 9th: Week 9 - Code Freeze
• Tuesday, March 16th: Week 10 - Docs Placeholder PR deadline
  • If this enhancement requires new docs or modification to existing docs, please follow the steps in the Open a placeholder PR doc to open a PR against k/website repo.

As a reminder, please link all of your k/k PR(s) and k/website PR(s) to this issue so we can track them.

Thanks!