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 是一个整数。
• 稳定版本的功能将出现在许多后续版本的已发布软件中。