Kubernetes - API

Kubernetes API 是系统声明性配置模式的基础。 Kubectl 命令行工具可用于创建、更新、删除和获取 API 对象。 Kubernetes API 充当 Kubernetes 不同组件之间的沟通者。


向 Kubernetes 添加 API

向 Kubernetes 添加新的 API 将为 Kubernetes 添加新功能,这将增加 Kubernetes 的功能。 然而,与此同时,它也会增加系统的成本和可维护性。 为了在成本和复杂性之间取得平衡,为此定义了一些集合。

添加的 API 应该对 50% 以上的用户有用。 在 Kubernetes 中没有其他方法可以实现该功能。 异常情况在 Kubernetes 的社区会议中讨论,然后添加 API。


API 更改

为了增加 Kubernetes 的能力,不断地向系统引入变化。 Kubernetes 团队在不删除或影响系统现有功能的情况下将功能添加到 Kubernetes。

为了演示一般过程,这里是一个(假设的)示例 −

  • 用户将 Pod 对象发布到 /api/v7beta1/...

  • JSON 被解组为 v7beta1.Pod 结构

  • 默认值应用于 v7beta1.Pod

  • v7beta1.Pod被转换成api.Pod结构

  • 验证api.Pod,并将任何错误返回给用户

  • api.Pod被转换为v6.Pod(因为v6是最新的稳定版本)

  • v6.Pod 被编组为 JSON 并写入 etcd

现在我们已经存储了 Pod 对象,用户可以在任何支持的 API 版本中获取该对象。 例如 −

  • 用户从 /api/v5/... 获取 Pod

  • etcd 读取 JSON 并解组v6.Pod 结构中

  • 默认值应用于 v6.Pod

  • v6.Pod被转换为api.Pod结构

  • api.Pod被转换成v5.Pod结构

  • v5.Pod 被编组为 JSON 并发送给用户

这个过程的含义是,API 更改必须谨慎并向后兼容。


API 版本控制

为了更容易支持多种结构,Kubernetes 支持多个 API 版本,每个版本位于不同的 API 路径,例如 /api/v1/apsi/extensions/v1beta1

Kubernetes 的版本控制标准在多个标准中定义。

Alpha 阿尔法级别

  • 此版本包含 alpha(例如 v1alpha1)

  • 这个版本可能有问题; 启用的版本可能有错误

  • 可以随时取消对错误的支持。

  • 建议仅用于短期测试,因为支持可能不会一直存在。

Beta 测试级别

  • 版本名称中包含 beta(例如 v2beta3)

  • 代码经过全面测试,启用的版本应该是稳定的。

  • 不会放弃对该功能的支持; 可能会有一些小的变化。

  • 建议仅用于非关键业务用途,因为后续版本中可能会出现不兼容的更改。

Stable 稳定级别

  • 版本名称是vX,其中X是一个整数。

  • 稳定版本的功能将出现在许多后续版本的已发布软件中。