Server Side Unknown Field Validation

[kevindelgado]

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.

[kevindelgado]

/sig api-machinery

[kevindelgado]

/milestone v1.23

[kevindelgado]

/stage alpha

[kevindelgado]

/tracked

[kevindelgado]

Hi @kevindelgado! This is @kevindelgado from the 1.23 Enhancements team here. Just checking in as we approach enhancements freeze on Thursday 09/09. Here's where this enhancement currently stands:

• KEP file using the latest template has been merged into the k/enhancements repo.
• KEP status is marked as implementable
• KEP has a test plan section filled out.
• KEP has up to date graduation criteria.
• KEP has a production readiness review that has been completed and merged into k/enhancements.

Looks like for this one we would just need the KEP & the PRR file to merge by enhancements freeze :)

All good now!

Thanks!

[kevindelgado]

Thanks for checking in @kevindelgado, I'll be sure to get the KEP and PRR merged in by enhancements freeze!