API互換性

cert-manager は、Kubernetes の非推奨ポリシーに記載されている、アップストリーム Kubernetes API と同じ API 互換性ポリシーに従うことを目指しています。

これは、ユーザーにとってスムーズなアップグレードとダウングレードの体験を保証するため、つまり、cert-manager のアップグレードまたはダウングレード後も、ユーザーの cert-manager カスタムリソースが同じように機能し続けるようにするためです。

場合によっては、ユーザーにアップグレード前にアクションを実行することを要求したり、API の互換性の約束から逸脱したりする必要があるかもしれませんが、これは絶対的な最後の手段として扱います。一般的に、変更が許容可能かどうかを判断する主な基準は、ユーザーの価値となるでしょう。

たとえば、本当に重大なバグが発生した場合、API フィールドのデフォルトの動作を変更することでAPI互換性の約束を破る修正は、許容される可能性があります。しかし、これまでのところ、そのような変更が必要になったことはありません。

アルファ/ベータ API バージョン

アップストリーム Kubernetes と同様に、アルファまたはベータ API バージョンを無期限に保持することを約束しません。

注意: Kubernetes の非推奨ポリシーでは、API の削除によって、削除されたバージョンで保存されたオブジェクトに問題が発生することが指摘されています。これを修正するために、リソースを移行するために一度実行できるカスタムツールを作成しました。