本页详述了管理员可以在不同的 Kubernetes 组件上指定的各种特性门控。
关于特性各个阶段的说明,请参见特性阶段。
概述 {#overview}
特性门控是描述 Kubernetes 特性的一组键值对。你可以在 Kubernetes 的各个组件中使用
--feature-gates 标志来启用或禁用这些特性。
如何启用特性门控 {#how-to-enable-feature-gates}
要为特定的 Kubernetes 组件启用或禁用某个特性门控,使用 --feature-gates 标志。
此标志接受由逗号分隔的 key=value 对的列表,其中每个 key 是特性门控的名称,
每个 value 可以是 true(启用)或 false(禁用)。
用法示例:
kube-apiserver --feature-gates=FeatureName1=true,FeatureName2=false
kubelet --feature-gates=GracefulNodeShutdown=true
每个 Kubernetes 组件只支持与其自身功能相关的特性门控。
使用 <component> -h 可以列出特定组件支持的所有特性门控。
如需了解在集群中配置特性门控的详细步骤, 参阅配置特性门控。
Kubernetes v 中的特性门控 {#list-of-gates}
如何启用特性门控
要为特定的 Kubernetes 组件启用或禁用特性门控,请使用 --feature-gates 标志。
此标志接受以逗号分隔的键值对列表,其中每个键是特性门控名称,值为
true(启用)或 false(禁用)。
用法示例:
kube-apiserver --feature-gates=FeatureName1=true,FeatureName2=false
kubelet --feature-gates=GracefulNodeShutdown=true
每个 Kubernetes 组件仅支持与其特性相关的特性门控。
使用 <component> -h 列出特定组件可用的特性门控。
有关在集群中配置特性门控的详细说明,请参阅配置特性门控。
Kubernetes 中的特性门控 {#list-of-gates}
下表总结了在不同的 Kubernetes 组件上可以设置的特性门控。
- 引入特性或更改其发布阶段后,"开始(Since)" 列将包含 Kubernetes 版本。
- "结束(Until)" 列(如果不为空)包含最后一个 Kubernetes 版本,你仍可以在其中使用特性门控。
- 如果某个特性处于 Alpha 或 Beta 状态,你可以在 Alpha 和 Beta 特性门控表中找到该特性。
- 如果某个特性处于稳定状态, 你可以在已毕业和废弃特性门控表中找到该特性的所有阶段。
- 已毕业和废弃特性门控表还列出了废弃的和已被移除的特性。
有关已移除的原有特性门控的参考信息, 请参阅已移除的特性门控。
Alpha 和 Beta 状态的特性门控 {#feature-gates-for-alpha-or-beta-features}
已毕业和已废弃的特性门控 {#feature-gates-for-graduated-or-deprecated-features}
使用特性 {#using-a-feature}
特性阶段 {#feature-stages}
处于 Alpha、Beta、GA 阶段的特性。
Alpha 特性代表:
- 默认禁用。
- 可能有错误,启用此特性可能会导致错误。
- 随时可能删除对此特性的支持,恕不另行通知。
- 在以后的软件版本中,API 可能会以不兼容的方式更改,恕不另行通知。
- 建议将其仅用于短期测试中,因为开启特性会增加错误的风险,并且缺乏长期支持。
Beta 特性代表:
- 通常默认启用。Beta API 组默认是被禁用的。
- 该特性已经经过良好测试。启用该特性是安全的。
- 尽管详细信息可能会更改,但不会放弃对整体特性的支持。
- 对象的架构或语义可能会在随后的 Beta 或稳定版本中以不兼容的方式更改。 当发生这种情况时,我们将提供迁移到下一版本的说明。此特性可能需要删除、编辑和重新创建 API 对象。 编辑过程可能需要慎重操作,因为这可能会导致依赖该特性的应用程序停机。
- 推荐仅用于非关键业务用途,因为在后续版本中可能会发生不兼容的更改。如果你具有多个可以独立升级的,则可以放宽此限制。
请试用 Beta 特性并提供相关反馈! 一旦特性结束 Beta 状态,我们就不太可能再对特性进行大幅修改。
General Availability(GA)特性也称为稳定特性,GA 特性代表着:
- 此特性会一直启用;你不能禁用它。
- 不再需要相应的特性门控。
- 对于许多后续版本,特性的稳定版本将出现在发行的软件中。
特性门控列表 {#feature-gates}
每个特性门控均用于启用或禁用某个特定的特性:
- Kubernetes 的弃用策略介绍了项目针对已移除特性和组件的处理方法。
- 从 Kubernetes 1.24 开始,默认不启用新的 Beta API。
启用 Beta 功能时,还需要启用所有关联的 API 资源。
例如:要启用一个特定资源,如
storage.k8s.io/v1beta1/csistoragecapacities, 请设置--runtime-config=storage.k8s.io/v1beta1/csistoragecapacities。 有关命令行标志的更多详细信息,请参阅 API 版本控制。 - 参阅配置特性门控了解启用特性门控的分步操作指南。
来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。
