Kubernetes API 聚合层

聚合层允许 Kubernetes 扩展核心 Kubernetes API 所提供的功能,以支持额外的 API。这些额外的 API 可以是现成的解决方案,例如度量服务器,也可以是您自己开发的 API。

聚合层不同于自定义资源定义 (CRD),CRD 是一种让kube-apiserver 识别新类型对象的方式。

聚合层

聚合层与 kube-apiserver 在同一进程中运行。在注册扩展资源之前,聚合层不执行任何操作。要注册 API,您需要添加一个 APIService 对象,该对象“声明”Kubernetes API 中的 URL 路径。此时,聚合层将把发送到该 API 路径(例如 /apis/myextension.mycompany.io/v1/…)的所有内容代理到已注册的 APIService。

实现 APIService 的最常见方法是在集群中运行一个或多个 Pod 中的 扩展 API 服务器。如果您使用扩展 API 服务器管理集群中的资源,则扩展 API 服务器(也称为“extension-apiserver”)通常与一个或多个控制器配对。apiserver-builder 库为扩展 API 服务器和相关的控制器提供了一个骨架。

响应延迟

扩展 API 服务器应与 kube-apiserver 之间具有低延迟网络。发现请求要求在五秒或更短的时间内从 kube-apiserver 往返。

如果您的扩展 API 服务器无法达到该延迟要求,请考虑进行更改以满足该要求。

下一步

或者:了解如何使用自定义资源定义扩展 Kubernetes API

上次修改时间为 2025 年 3 月 27 日太平洋标准时间上午 10:09:更新 content/en/docs/concepts/extend-kubernetes/api-extension/declarative-validation.md (210060f584)