Kubernetes – API

Kubernetes API是系统描述性配置的基础。 Kubectl 命令行工具被用于创建、更新、删除、获取API对象。

Kubernetes 通过API资源存储自己序列化状态(现在存储在etcd)。

Kubernetes 被分成多个组件,各部分通过API相互交互。

向Kubernetes添加API

向Kubernetes添加新API,将增加Kubernetes的功能。但是,同时也会增加系统的成本和可维护性。为了在成本和复杂性之间权衡,定义了几个API集合。

Kubernetes社区添加API,会考虑:

  • 该API应该对超过50%的用户有用
  • 在Kubernetes中没有其他方法实现该功能

API 变更

任何成功的系统都需要迭代,Kubernetes API也会不断地变化和增长。

API 变更会尽量考虑向前兼容,不影响用户使用。

通常,新的API资源和新的资源字段可能会频繁添加。删除资源或字段需要遵循API弃用策略。
API更改文档详细说明了什么是兼容更改以及如何更改API。

API版本

为了使删除字段或者重构资源表示更加容易,Kubernetes 支持 多个API版本。每一个版本都在不同API路径下,例如 /api/v1 或者 /apis/extensions/v1beta1。

不同的API版本名称意味着不同级别的软件稳定性和支持程度。 每个级别的标准在API变更文档中有更详细的描述。 内容主要概括如下:

  • Alpha 测试版本:
    • 版本名称包含了 alpha (例如:v1alpha1)。
    • 可能是有缺陷的。启用该功能可能会带来隐含的问题,默认情况是关闭的。
    • 支持的功能可能在没有通知的情况下随时删除。
    • API的更改可能会带来兼容性问题,但是在后续的软件发布中不会有任何通知。
    • 由于bugs风险的增加和缺乏长期的支持,推荐在短暂的集群测试中使用。
  • Beta 测试版本:
    • 版本名称包含了 beta (例如: v2beta3)。
    • 代码已经测试过。启用该功能被认为是安全的,功能默认已启用。
    • 所有已支持的功能不会被删除,细节可能会发生变化。
    • 对象的模式和/或语义可能会在后续的beta测试版或稳定版中以不兼容的方式进行更改。 发生这种情况时,我们将提供迁移到下一个版本的说明。 这可能需要删除、编辑和重新创建API对象。执行编辑操作时需要谨慎行事,这可能需要停用依赖该功能的应用程序。
    • 建议仅用于非业务关键型用途,因为后续版本中可能存在不兼容的更改。 如果您有多个可以独立升级的集群,则可以放宽此限制。
    • 请尝试我们的 beta 版本功能并且给出反馈!一旦他们退出 beta 测试版,我们可能不会做出更多的改变。
  • 稳定版本:
    • 版本名称是 vX,其中 X 是整数。
    • 功能的稳定版本将出现在许多后续版本的发行软件中。


浙ICP备17015664号 浙公网安备 33011002012336号 联系我们 网站地图  
@2019 qikegu.com 版权所有,禁止转载