Enforcing API Standards for K8s CRDs at Scale using OpenAPI, Arazzo & Overlay
summary
Converts CRDs into a machine‑readable OpenAPI schema via controller‑gen or openapi‑gen, runs Spectral linting in CI, and applies declarative Arazzo workflows plus Overlay patches to enforce environment‑specific constraints; examples include default replicas 3 and overlays setting dev 1–10 prod 3–50 other 1–100 and auto‑fixing an int32 vs pointer int32 drift that caused deploy failures. Uses OpenAPI 3.2, Arazzo 1.0.1 and Overlay 1.0 and reports fewer validation errors and faster deployments.
AI-written summary · about
chapters (8)
- 0:00Introduction
- 2:18Three pillars: OpenAPI, Arazzo, Overlay
- 4:04CRDs to OpenAPI specs
- 6:51Arazzo workflow
- 10:22CI/CD integration benefits
- 11:46Overlay for environment-specific API modifications
- 15:16Implementation phases
- 17:24Team adoption & final thoughts
related talks
22mThe Arazzo Specification: A Tapestry for API Workflows.
30mDesigning a Composable API Platform Powered by Open Standards
35mOpensource API Tools to agile your apifirst strategy.
31mBeyond OpenAPI: API Workflows That AI Agents Can Actually Execute
47mContract-Driven API Development with OpenAPI Specification
34mExtending Kubernetes 101
45mOpenAPI for Web Developers
28mAdvanced API Machinery Topics: Aggregated API Servers and OpenAPI v3