OpenAPI Specs – Towards Native User Experience of CRDs
summary
Kubernetes 1.14 begins publishing OpenAPI specs for CRDs, which enables kubectl explain for CRDs and better IDE manifest completion; the talk shows concrete examples of CRD validation encoded as OpenAPI rules, demos client generation for languages beyond Go, and proposes a standard openapi-spec-gen that extracts specs from Go types (using controller-tools). It also demonstrates limits: polymorphic fields and some validation semantics cannot be expressed in OpenAPI, and conversion/advanced logic still needs controllers.
AI-written summary · about
chapters (7)
- 0:00Start
- 4:34OpenAPI v3 schemas
- 15:41OpenAPI Publishing
- 18:39Problematic OpenAPI v3
- 19:29Limits of Expressivity
- 23:34Pruning with a structural schema
- 24:54Controlling Pruning
related talks
28mKubernetes CRD Design for the Long Haul: Tips, Tricks, and Lessons Learned
34mExtending Kubernetes 101
19mKeynote: CRDs, No Longer 2nd Class Thing!
06mExtending the Kubernetes API
01h 39mTutorial: Mastering Multi-version CRDs: From YAML to a Serious Development Project
36mDesign Conventions You Need to Know When Extending Kubernetes with CRDs
19mKeynote: CRDs, No Longer 2nd Class Thing!
36mSIG API Machinery Deep Dive