本文发表于一年多前。旧文章可能包含过时内容。请检查页面中的信息自发布以来是否已变得不正确。

介绍 Kubernetes API 版本 v1beta3

2015 年 4 月 16 日，星期四

在过去的几个月里，我们一直在努力清理 API（详情请参阅 https://github.com/GoogleCloudPlatform/kubernetes/issues/1519）。结果是 v1beta3，它被认为是 v1 API 的发布候选版本。

我们希望您尽快迁移到这个新的 API 版本。v1beta1 和 v1beta2 已弃用，并将在 6 月底，即我们推出 v1 API 后不久移除。

截至最新版本 v0.15.0，v1beta3 是主要的默认 API。我们已更改默认的 kubectl 和客户端 API 版本以及默认存储版本（这意味着持久化在 etcd 中的对象将在重写时从 v1beta1 转换为 v1beta3）。

您可以查看 v1beta3 的示例，例如：

为了帮助过渡，我们还创建了一个转换工具，并整理了一份重要的不同 API 变更列表。

资源 id 现在称为 name。
name、labels、annotations 和其他元数据现在嵌套在一个名为 metadata 的映射中。
desiredState 现在称为 spec，currentState 现在称为 status。
/minions 已移至 /nodes，并且资源类型为 Node。
命名空间是必需的（对于所有命名空间资源），并且已从 URL 参数移至路径：/api/v1beta3/namespaces/{namespace}/{resource_collection}/{resource_name}。
所有资源集合的名称现在都小写 - 而不是 replicationControllers，请使用 replicationcontrollers。
要监视资源的更改，请打开到集合 URL 的 HTTP 或 Websocket 连接，并提供 ?watch=true URL 参数以及要监视的 resourceVersion 参数。
容器 entrypoint 已重命名为 command，command 已重命名为 args。
容器、卷和节点资源以嵌套映射（例如，resources{cpu:1}）而不是单个字段表示，并且资源值支持缩放后缀而不是固定比例（例如，毫核）。
重启策略简单地表示为字符串（例如，“Always”）而不是嵌套映射（“always{}”）。
卷 source 已内联到 volume 中，而不是嵌套。
主机卷已从 hostDir 更改为 hostPath，以更好地反映它们可以是文件或目录。

API 的最新生成的 Swagger 规范在此处：

有关我们 API 版本控制方法和过渡的更多详细信息，请参见此处：

我们发现的另一个变化是，随着 kubectl 中默认 API 版本的更改，使用 “-o template” 的命令将中断，除非您指定 “--api-version=v1beta1” 或更新到 v1beta3 语法。此类更改的示例可见此处：

如果您使用 “-o template”，我建议始终明确指定 API 版本，而不是依赖默认值。我们将来可能会将此设置添加到 kubeconfig 中。

如果您有任何问题，请告诉我们。一如既往，我们可以在 IRC (#google-containers) 和 github issues 上找到。