etcd 特性

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

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

实验性

为了尽早获得用户反馈，任何新功能通常都会以实验性功能的形式引入。您可以通过查看参数名称是否以 --experimental 为前缀来识别实验性功能。使用实验性功能时，请注意以下几点：

• 由于缺乏广泛的用户测试，可能存在缺陷。启用该功能后可能无法按预期工作。
• 默认情况下处于禁用状态。
• 项目组可能随时在不发出通知的情况下停止对该功能的支持
  • 除非该功能升级为稳定功能，否则它可能在下一个次要版本或主要版本中被移除，且不受功能弃用政策的约束。
  • 项目团队欢迎用户报告与实验性功能相关的任何问题，但这些问题的处理优先级可能会低于与稳定功能相关的问题。
• 当实验性功能升级至稳定阶段时，其对应的功能标志将被弃用。用户应尽快开始使用相应的稳定功能标志。

稳定

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

• 在 etcd 支持的发布版本中提供支持。
• 可能默认启用。
• 若要终止支持，必须遵循功能弃用政策。

不安全

不安全功能较为罕见，列于 etcd 使用文档中的 不安全功能： 部分。它们默认是禁用的，必须严格按照文档谨慎使用。不安全功能可能在下一个次要或主要版本中被移除，且不受功能弃用政策的约束。

功能弃用

实验性

当实验性功能升级到稳定阶段时，即表示该实验性功能已被弃用。

• 实验性功能的文档将显示弃用消息，并建议使用相关的稳定功能标志。例如：已弃用。请改用 <功能名称>。
• 被弃用的功能将在后续版本中被移除。

稳定

随着项目的发展，某些稳定功能有时也需要被弃用并移除。发生这种情况时，

• 在计划弃用的版本发布之前，功能文档将提前显示警告信息。例如：将在 <版本> 中弃用。。如果已有新的功能计划用于替代该“即将弃用”的功能，则文档还会提供相应提示，例如：请改用 <功能名称>。
• 该功能将在计划的版本中被正式弃用。届时，功能文档将显示弃用消息，并推荐使用相关的稳定功能。例如：已弃用。请改用 <功能名称>。
• 被弃用的功能将在后续版本中被移除。