大网数据广告活动
Kubernetes 部署与运维

特性门控

· 52CE 我爱测

特性门控是描述 Kubernetes 特性的一组键值对。你可以在 Kubernetes 的各个组件中使用 `--feature-gates` 标志来启用或禁用这些特性。

本页详述了管理员可以在不同的 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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
Kubernetes 文档贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。