第1章 API ティアについて

市販のすべての API、コンポーネント、および機能は、次のいずれかのサポートレベルに関連付けられています。

API ティア 1

API とアプリケーションオペレーティング環境 (AOE) は、メジャーリリース内で安定しています。これらはメジャーリリース内で非推奨になる可能性があります。ただし、次のメジャーリリースまで削除されません。

API ティア 2

API と AOE は、メジャーリリース内で最低 9 か月間、または非推奨の発表から 3 つのマイナーリリースのいずれか長い方で安定しています。

API ティア 3

このレベルは、OperatorHub を介して OpenShift Container Platform に含まれる言語、ツール、アプリケーション、およびオプションのオペレーターに適用されます。各コンポーネントは、API および AOE がサポートされるライフサイクルを指定します。言語ランタイム固有のコンポーネントの新しいバージョンは、マイナーバージョンからマイナーバージョンまで、API および AOE と可能な限り互換性があるように試みます。ただし、マイナーバージョンとマイナーバージョンの互換性は保証されません。

演算子およびオペランドと呼ばれる、演算子ハブを介して継続的な更新を受け取るコンポーネントおよび開発ツールは、API ティア 3 と見なす必要があります。開発者は注意を払い、これらのコンポーネントがマイナーリリースごとにどのように変化するかを理解する必要があります。ユーザーは、コンポーネントによって文書化された互換性ガイドラインを参照することが推奨されます。

API ティア 4

互換性は提供されません。API および AOE はいつでも変更できます。これらの機能は、長期サポートを必要とするアプリケーションで使用することはできません。

Operator がタスクを実行するためにカスタムリソース定義 (CRD) を内部で使用する方法は一般的な方法です。これらのオブジェクトは Operator の外部にあるアクターによって使用されることが意図されておらず、非表示にされることが意図されています。CRD が Operator の外部のアクターによる使用を意図していない場合は、ClusterServiceVersion (CSV) の operators.operatorframework.io/internal-objects アノテーションを指定して、対応するリソースが内部使用のみである必要があります。また、CRD は、ティア 4 として排他的にラベル付けできます。