etcd 功能

本文概述了 etcd 的各项功能，旨在帮助用户更好地理解这些功能及其相关弃用流程。若想了解 etcd 功能的开发方式，请参阅 开发指南 。

etcd 功能分为三个阶段：实验性、稳定和不安全。可通过运行 etcd --help 获取功能列表。

实验性

为获取早期反馈，任何新功能通常以实验性功能的形式添加。可通过标志名称识别实验性功能，其名称应以 --experimental 为前缀。使用实验性功能时，请注意以下事项：

• 由于缺乏用户测试，该功能可能存在缺陷。启用该功能可能无法按预期工作。
• 默认情况下处于禁用状态。
• 项目团队可能随时停止支持该功能，恕不另行通知。
  • 若该功能未晋升为稳定功能，则可在下一个次要版本或主要版本中直接移除，无需遵循功能弃用 政策。
  • 项目团队欢迎用户报告与实验性功能相关的问题。但此类问题的优先级可能低于与稳定功能相关的问题。
• 实验性功能晋升为稳定功能 时，其实验性功能标志将被弃用。应尽快改用稳定功能标志。

稳定

这是 etcd 中功能最常见的阶段。稳定功能具有以下特征：

• 作为 etcd 支持版本的一部分提供支持。
• 可以默认启用。
• 停止支持必须遵循功能弃用 政策。

不安全

不安全功能较为罕见，列于 etcd 使用文档的 Unsafe feature: 章节中。默认情况下，这些功能处于禁用状态。使用时应谨慎，并遵循文档说明。不安全功能可能在下一个次要版本或主要版本中被移除，且无需遵循功能弃用策略。

功能弃用

实验性

当实验性功能进入稳定阶段时，即被弃用。

• 实验性功能的文档将显示弃用提示，并建议使用相关的稳定功能标志。例如 DEPRECATED. Use <feature-name> instead.
• 已弃用的功能将在后续版本中移除。

稳定

随着项目演进，某些稳定功能有时可能需要被弃用并移除。当发生这种情况时：

• 功能文档将在计划发布前显示警告消息。例如 To be deprecated in <release>.。若已有新功能计划替代 To be deprecated 功能，则文档还将提供相应说明。例如 Use <feature-name> instead.。
• 该功能将在计划发布中被弃用。此时，功能文档将显示弃用消息，并建议使用相关稳定功能。例如 DEPRECATED. Use <feature-name> instead.。
• 已弃用的功能将在后续发布中移除。