Kubernetes(k8s) API

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


向 Kubernetes 添加 API

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

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


API 更改

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

为了演示一般过程,下面是一个(假设的)示例

  • 用户 POST 一个 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
  • JSON 从 etcd 读取并解组为 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 是一个整数。
  • 稳定版本的功能将出现在许多后续版本的已发布软件中。

查看笔记

扫码一下
查看教程更方便