Deprecate v1.Endpoints

[danwinship]

Enhancement Description

• One-line enhancement description (can be used as a release note): Officially deprecate the Endpoints API in favor of EndpointSlices, and ensure that it is possible to run clusters without the Endpoints controller.
• Kubernetes Enhancement Proposal: https://github.com/kubernetes/enhancements/tree/master/keps/sig-network/4974-deprecate-endpoints
• Discussion Link: none, though discussed in person a bit at KubeCon
• Primary contact (assignee): @danwinship
• Responsible SIGs: sig-network
• Enhancement target (which target equals to which milestone):
  • Alpha release target (x.y): 1.33
  • Beta release target (x.y):
  • Stable release target (x.y):
• Alpha
  • KEP (k/enhancements) update PR(s): KEP-4974: initial proposal for deprecating v1.Endpoints #4975
  • Code (k/k) update PR(s):
    • Remove all references to v1.Endpoints from non-network e2e tests kubernetes#128896
    • Test EndpointSlice in dual-stack e2e tests kubernetes#128898
    • Try to clarify EndpointSlice semantics some more kubernetes#129886
    • Mark v1.Endpoints deprecated kubernetes#130098
  • Docs (k/website) update PR(s):
    • Update docs for deprecation of Endpoints API website#49831 (docs)
    • KEP-4974 endpoints deprecation blog post for 1.33 website#49976 (blog post)

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

[danwinship]

/sig network

[danwinship]

/label lead-opted-in
/milestone v1.33

targeting alpha for 1.33

[dipesh-rawat]

Hello @danwinship 👋, v1.33 Enhancements team here.

Just checking in as we approach enhancements freeze on 02:00 UTC Friday 14th February 2025 / 19:00 PDT Thursday 13th February 2025.

This enhancement is targeting stage alpha for v1.33 (correct me, if otherwise)
/stage alpha

Here's where this enhancement currently stands:

• KEP readme using the latest template has been merged into the k/enhancements repo.
• KEP status is marked as implementable for latest-milestone: v1.32.
• KEP readme has up-to-date graduation criteria
• KEP has a production readiness review that has been completed and merged into k/enhancements. (For more information on the PRR process, check here). If your production readiness review is not completed yet, please make sure to fill the production readiness questionnaire in your KEP by the PRR Freeze deadline on Thursday 6th February 2025 so that the PRR team has enough time to review your KEP.

For this KEP, we would need to update the following:

• Create the KEP readme using the latest template and merge it in the k/enhancements repo.
• Ensure that the KEP has undergone a production readiness review and has been merged into k/enhancements.

The status of this enhancement is marked as At risk for enhancements freeze. Please keep the issue description up-to-date with appropriate stages as well.

If you anticipate missing enhancements freeze, you can file an exception request in advance. Thank you!