Enhancement Description

• One-line enhancement description (can be used as a release note): Add the ability to optionally trigger schema validation on the API server that errors when unknown fields are detected.

• Kubernetes Enhancement Proposal: https://github.com/kubernetes/enhancements/tree/master/keps/sig-api-machinery/2885-server-side-unknown-field-validation

• Discussion Link: sig-meeting, initial public doc

• Primary contact (assignee): @kevindelgado

• Responsible SIGs: api-machinery

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

  • Alpha release target (x.y): 1.23
  • Beta release target (x.y): 1.25
  • Stable release target (x.y): 1.27

• Alpha

  • KEP (k/enhancements) update PR(s): KEP-2885: Add Server-Side Unknown Field Validation KEP #2886
  • Code (k/k) update PR(s): Server Side Strict Field Validation kubernetes#105916
  • Docs (k/website) update PR(s): Document server side field validation website#30532 Relevant docs for new query parameter are autogenerated from source code in k/k. No additional docs needed for alpha.

• Beta

  • KEP (k/enhancements) update PR(s): KEP-2885: Beta Graduation Criteria for Field Validation #3081
  • Code (k/k) update PR(s):
    • Kubectl validation defaults to server-side: Server Side Field Validation Support For Kubectl kubernetes#108350
    • beta enablement: ServerSideFieldValidation Beta Graduation kubernetes#108889
    • Additional 1.24 follow ups from alpha
      • Look into strict handling of nested object decoding: PR
      • Customresource_handler unit tests of field validation: PR
      • Endpoints handler unit testing of field validation: PR
      • Integration tests should check for exact match of strict errors PR
    • Add unknown metadata field validation tests kubernetes#109316
    • store err type and path separately in strict errors kubernetes-sigs/json#16
    • server-side metadata unknown field validation kubernetes#109494
    • Graduate server side validation to beta kubernetes#110178
  • Docs (k/website) update(s):
    • Field Validation API Concepts website#32357

• Stable

  • KEP (k/enhancements) update PR(s):KEP-2885 Field Validation 1.27 GA graduation #3725
  • Code (k/k) update PR(s):
    • Field validation e2e tests and GA graduation kubernetes#115271
  • Docs (k/website) update(s):
    • docs for field validation GA #39715 website#39716

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