OpenAPI Enum Types

[jiahuif]

Enhancement Description

• One-line enhancement description (can be used as a release note): Detect enum types in resource types, and generate enum definition in OpenAPI spec. This feature optionally depends on OpenAPI v3 #2896 , and should remain compatible with it.
• Kubernetes Enhancement Proposal: https://github.com/kubernetes/enhancements/blob/master/keps/sig-api-machinery/2887-openapi-enum-types/README.md
• Discussion Link:
• Primary contact (assignee): @jiahuif
• 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.24
  • Stable release target (x.y):
• Alpha
  • KEP (k/enhancements) update PR(s): KEP-2887: Enum Types for OpenAPI #2888
  • Code (k/k) update PR(s):
    • Enum type generator kube-openapi#242
    • Add Support for OpenAPIEnum in OpenAPI v2 kubernetes#105057
    • add feature gate for OpenAPIEnums. kubernetes#105054
  • Docs (k/website) update PR(s): None needed. The documentation of this feature will be auto-generated from OpenAPI Spec.
• Beta
  • KEP (k/enhancements) update PR(s): KEP-2887: OpenAPI Enum Types to Beta #3184
  • Code (k/k) update PR(s): Graduate OpenAPI Enums to beta kubernetes#108898
  • Docs (k/website) update(s): OpenAPIEnums feature is beta in 1.24 website#32594
• Stable
  • KEP (k/enhancements) update PR(s):
    • KEP-2887: modify GA criteria #4510
    • [ ]
  • Code (k/k) update PR(s):
  • Docs (k/website) update(s):

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

[mysunshine92]

/sig api-machinery

[Priyankasaggu11929]

/milestone v1.23

[k8s-ci-robot]

@Priyankasaggu11929: The provided milestone is not valid for this repository. Milestones in this repository: [keps-beta, keps-ga, v1.17, v1.18, v1.19, v1.20, v1.21, v1.22, v1.23, v1.24, v1.25, v1.26]

Use /milestone clear to clear the milestone.

In response to this:

/milestone 1.23

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

[Priyankasaggu11929]

/milestone v1.23

[Priyankasaggu11929]

Hello @jiahuif! 1.23 Enhancements team here. Just checking in as we approach enhancements freeze on Today 09/09/2021 23:59 PT. 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 require getting this PR #2888 merged.

Thanks!

[jiahuif]

@Priyankasaggu11929 #2888 merged, should be good to go.

[Priyankasaggu11929]

Thank you so much @jiahuif. With the KEP PR merged, this enhancement is ready for the 1.23 enhancements freeze.