Consider Terminating Pods in Deployments

[kannon92]

Enhancement Description

• One-line enhancement description (can be used as a release note): For Deployment controllers we want to optionally include a way for users to include terminating pods in the active pod count.

• Kubernetes Enhancement Proposal: https://github.com/kubernetes/enhancements/blob/master/keps/sig-apps/3973-consider-terminating-pods-deployment/README.md

• Discussion Link: Jobs create replacement Pods as soon as a Pod is marked for deletion kubernetes#115844

• Primary contact (assignee): @atiratree

• PRs by stage and milestone:

• Alpha - v1.33

  • KEP (k/enhancements) update PR(s):
    • KEP-3973: Consider Terminating Pods in Deployments #4357
    • KEP-3973: Update PodReplacementPolicy for Deployments #4670
    • KEP-3973: fix scaling calculations in PodReplacementPolicy KEP #4763
    • KEP-3973: fix replicaset preference in leftover calculation in PodReplacementPolicy KEP #4774
    • KEP-3973: Update PodReplacementPolicy alpha to 1.32 #4903
  • Code (k/k) update PR(s):
    • add PodReplacementPolicy for Deployments: terminating pods kubernetes#128546
    • rename DeploymentPodReplacementPolicy FG to DeploymentReplicaSetTerminatingReplicas kubernetes#131088
    • disable terminatingReplicas reconciliation in ReplicationController kubernetes#131822
  • Docs (k/website) update PR(s):
    • [KEP-3973]: document .status.terminatingReplicas enabled by DeploymentPodReplacementPolicy feature website#49896
    • [KEP-3973]: update the DeploymentPodReplacementPolicy FG references to DeploymentReplicaSetTerminatingReplicas website#50287

• Beta - v1.35

  • KEP (k/enhancements) update PR(s):
    • KEP-3973: Consider deployment completion in DeploymentPodReplacementPolicy #4976
    • KEP-3973: update Consider Terminating Pods in Deployments #5398
    • KEP-3973: update milestone in Consider Terminating Pods in Deployments #5568
    • KEP-3973, KEP-5882: split DeploymentReplicaSetTerminatingReplicas and DeploymentPodReplacementPolicy features into two standalone KEPs for easier tracking. #5883
  • Code (k/k) update PR(s):
    • add integration tests for pod replacement during scaling and Recreate/RollingUpdate strategies kubernetes#134959
    • promote DeploymentReplicaSetTerminatingReplicas to Beta kubernetes#133087
    • feat: add kube_deployment_status_replicas_terminating and kube_replicaset_status_terminating_replicas metrics kube-state-metrics#2708
  • Docs (k/website) update(s):
    • [KEP-3973] promote DeploymentReplicaSetTerminatingReplicas to beta website#51502
      Please keep this description up to date. This will help the Enhancement Team to track the evolution of the enhancement efficiently.

[kannon92]

/sig apps

[atiratree]

@kannon92 can you please link a correct KEP in the description?

[dejanzele]

As discussed with @kannon92, I will be taking over this KEP.

/assign dejanzele

[atiratree]

@dejanzele I had a similar discussion with @kannon92 some time ago about this as well. And I have the KEP mostly written, just need to finish it..

[atiratree]

@kannon92 @dejanzele I have opened the new version of the KEP in #4357.

[kannon92]

/assign @atiratree