API 相容性

cert-manager 的目標是遵守與上游 Kubernetes API 相同的 API 相容性政策，如Kubernetes 棄用政策中所述。

這是為了確保使用者擁有流暢的升級和降級體驗，也就是確保使用者的 cert-manager 自訂資源在 cert-manager 升級或降級後仍以相同方式運作。

在某些情況下，我們可能需要要求使用者在升級前採取行動，或者可能需要偏離 API 相容性承諾，但我們會將此視為絕對最後的手段。一般來說，我們判斷變更是否可接受的主要標準將會是使用者價值。

例如，如果發生非常嚴重的錯誤，透過變更 API 欄位的預設行為來打破 API 相容性承諾的修復可能是可以接受的。然而，到目前為止，還沒有出現過需要進行此類變更的情況。

Alpha / Beta API 版本

如同上游 Kubernetes 一樣，我們不承諾無限期地保留 alpha 或 beta API 版本。

注意： Kubernetes 的棄用政策指出，移除 API 會導致儲存在已移除版本中的物件出現問題。為了修正此問題，我們編寫了一個自訂工具，使用者可以執行一次以遷移其資源。