API 兼容性

cert-manager 旨在遵守与上游 Kubernetes API 相同的 API 兼容性策略，如Kubernetes 弃用策略中所述。

这是为了确保用户能够平滑地进行升级和降级，即确保用户在升级或降级 cert-manager 后，其 cert-manager 自定义资源能够继续以相同的方式运行。

在某些情况下，我们可能需要要求用户在升级之前采取行动，或者可能需要偏离 API 兼容性承诺，但我们将把这作为绝对的最后手段。总的来说，我们用来判断更改是否可接受的主要标准是用户价值。

例如，在遇到真正严重的错误时，通过更改 API 字段的默认行为来破坏 API 兼容性承诺的修复可能是可接受的。然而，到目前为止，还没有必要进行此类更改。

Alpha/Beta API 版本

与上游 Kubernetes 一样，我们不会承诺无限期保留 alpha 或 beta API 版本。

在 cert-manager v1.7 中所有早于 v1 的 alpha 和 beta API 版本已被移除.

注意：Kubernetes 的弃用策略指出 API 移除会导致存储在移除版本中的对象出现问题。为了解决这个问题，我们编写了一个自定义工具，用户可以运行一次来迁移他们的资源。