Leader Migration for Controller Managers

[jiahuif]

Enhancement Description

• One-line enhancement description (can be used as a release note): kube-controller-manager and cloud-controller-manager can apply new controller-to-controller-manager assignment in HA control plane without downtime.
• Kubernetes Enhancement Proposal: https://github.com/kubernetes/enhancements/tree/master/keps/sig-cloud-provider/2436-controller-manager-leader-migration
• Discussion Link:
  • cloud controller manager migration: default values and lease types update. #2083
  • (sig-cloudprovider agenda) https://docs.google.com/document/d/1KLsGGzNXQbsPeELCeF_q-f0h0CEGSe20xiwvcR2NlYM/
• Primary contact (assignee): @jiahuif
• Responsible SIGs: CloudProvider
• 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):
    • cloud controller manager migration: default values and lease types update. #2083
    • PRR KEP-2436 PRR: Controller Manager Leader Migration to alpha #2477
    • (KEP-2436) fix errors in sample configuration and formatting. #2548
  • Code (k/k) update PR(s):
    • leader migration configuration: parsing & validation. kubernetes#96226
    • register scheme for controller-manager kubernetes#96133
    • add configuration for controller migration. kubernetes#94205
    • Leader Migration (KEP-2477): options parsing kubernetes#99507
    • (KEP-2436) implementation of leader migration for controller manager. kubernetes#96541
  • Docs (k/website) update PR(s):
    • (KEP-2436) Task: Controller Manager Leader Migration website#26970
• Beta
  • KEP (k/enhancements) update PR(s):
    • PRR PRR: KEP-2436 Leader Migration for Controller Managers to beta #2687
    • KEP-2436: wildcard and default value #2731
  • Code (k/k) update PR(s):
    • Leader Migration: wildcard and default value kubernetes#102711
    • KEP-2436 Leader Migration: to beta kubernetes#103533
  • Docs (k/website) update(s):
    • KEP-2436 Leader Migration: to beta website#28882
• Stable
  • KEP (k/enhancements) update PR(s): KEP-2436 Leader Migration to GA #3183
  • Code (k/k) update PR(s): Graduate Leader Migration to GA kubernetes#109072 v1 types for Leader Migration kubernetes#108016
  • Docs (k/website) update(s): Leader Migration to GA website#32052

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

[jiahuif]

/sig cloud-provider
/assign
/cc @cheftako @andrewsykim @nckturner
replaces #991

[annajung]

Hi @jiahuif 1.21 Enhancements Lead here, could you clarify which stage this enhancement is graduating to?

Also, is there an open PR to update the current KEP? At the current state, it's at risk of being removed from the milestone for not meeting the PRR requirements.

kep.yaml and KEP template needs to be updated to the latest and it must have PRR approval.

I also noticed this issue replaced #991, in the same PR, could you also rename the KEP to match the new issue number #2436?

Also, enhancements freeze is in effect EOD today, Feb 9th.
Please make sure all requirements are met before then.

Thank you!

[jiahuif]

• clarify which stage this enhancement is graduating to: alpha
  • update in KEP
• PRR PR.
• update kep.yaml and KEP to latest template
• PRR approval
• rename KEP

[jiahuif]

/cc @cheftako @jpbetz @andrewsykim @nckturner @leilajal

[jiahuif]

Status for being "tracked", targeting v1.21 as alpha

• Merged in an implementable state
• Have test plans
• Have graduation criteria
• Have an open issue in the release milestone
• Have Production Readiness Review (merged as KEP-2436 PRR: Controller Manager Leader Migration to alpha #2477 )

[annajung]

With PR #2477 merged, this enhancement meets all the criteria for the Enhancements freeze 👍