Advanced API Machinery Topics: Aggregated API Servers and OpenAPI v3

on YouTube ↗28m

" summary

Kubernetes ships openapi v3 in Kubernetes 1.24 that preserves structural-schema features (oneOf, anyOf, default, nullable), exposes /openapi/v3 and per-group endpoints to avoid multi-megabyte aggregates, and adds cache-busting hashes with Cache-Control: immutable to cut discovery traffic; GA migration and client functions (OpenAPIV3) are underway. Aggregated API servers proxy via APIService with delegated auth and must authorize both sides; examples: OpenShift uses protobuf storage for speed, metrics-server is stateless, Prometheus adapter works, but aggregated API servers can cause namespace finalizers to hang and cannot share a group/version with CRDs.

AI-written summary · about

" chapters (10)

1. 0:00Start
2. 13:40Overview
3. 15:27kube-apiserver routing example 1
4. 15:58ext-apiserver authentication
5. 17:05Authorization?
6. 17:21kube-apiserver authorization
7. 20:29No storage: metrics server
8. 20:59Multiple implementations: metrics
9. 24:00Namespace deletion cycle
10. 26:56SIG API Machinery

" related talks

• 29mSIG API Machinery in the Era of AI: UpdatesFederico Bongiovanni · KubeCon + CloudNativeCon Japan 2026
• 36mApiserver Builder: Extending Kubernetes via Aggregated ApiserverMin Kim · KubeCon + CloudNativeCon + Open Source Summit China 2021
• 38mDeep Dive: API Machinery SIGDaniel Smith, David Eads · KubeCon + CloudNativeCon Europe 2019
• 09mEverything You Need to Know About OpenAPI 3.0Erin McKean · The Lead Developer New York 2018
• 26mKubernetes-style APIs of the FutureDaniel Smith · KubeCon + CloudNativeCon Europe 2018
• 05mKubernetes API ExplainedSalman Iqbal · DevOpsDays London 2022
• 08mKubernetes: The API of EverythingTibo Beijen · Cloud Native University Europe 2026
• 01h 00mContract First API Design with OpenAPI V3Darrel Miller · NDC Minnesota 2018