第1章 API 階層について
このガイダンスでは、レイヤー化された OpenShift Container Platform オファリングを説明しません。
ベアメタル設定の API 層は、ハードウェアと直接対話する機能を除いて、仮想化設定にも適用されます。ハードウェアに直接関連するこれらの機能には、ハードウェアベンダーが提供するレベルを超えるアプリケーションオペレーティング環境 (AOE) の互換性レベルはありません。たとえば、グラフィックスプロセッシングユニット (GPU) 機能に依存するアプリケーションは、GPU ベンダードライバーによって提供される AOE 互換性の対象となります。
クラウド固有の統合ポイントのクラウド環境の API 層には、ホスティングクラウドベンダーによって提供されるレベルを超える API または AOE の互換性レベルはありません。たとえば、コンピューティング、入力、またはストレージの動的管理を実行する API は、クラウドプラットフォームによって公開されている基盤となる API 機能に依存しています。クラウドベンダーが前提条件の API を変更する場合、Red Hat は、クラウドインフラストラクチャーベンダーが現在提供している機能を使用して API のサポートを維持するための商業的に合理的な取り組みを提供します。
Red Hat をお使いのアプリケーション開発者は、未特定の実装に特有の動作への依存や、特定の API 実装におけるバグへの依存を防ぐために、アプリケーション開発者が依存する動作が、API の公式ドキュメントで明示的に定義されていることを確認することが求められます。たとえば、Ingress ルーターの新しいリリースは、アプリケーションが文書化されていない API を使用するか、未定義の動作に依存している場合に、過去のリリースとは互換性がない場合があります。
1.1. API 階層
商用サポートされているすべての API、コンポーネント、および機能は、次のいずれかのサポートレベルに関連付けられています。
API 階層 1
API とアプリケーション動作環境 (AOE) は、メジャーリリースの間は安定性が確保されます。これらはメジャーリリース内で非推奨になる可能性があります。ただし、次のメジャーリリースまで削除されません。
API 階層 2
API と AOE は、メジャーリリース内で最低 9 か月間、または非推奨の発表から 3 つのマイナーリリースのいずれか長い方で安定しています。
API ティア 3
このレベルは、Operator Hub を介して OpenShift Container Platform に含まれる言語、ツール、アプリケーション、およびオプションのオペレーターに適用されます。各コンポーネントは、API および AOE がサポートされるライフサイクルを指定します。言語ランタイム固有のコンポーネントの新しいバージョンは、マイナーバージョンからマイナーバージョンまで、API および AOE と可能な限り互換性があるように試みます。ただし、マイナーバージョン間の互換性は保証されません。
Operator Hub (Operator およびオペランドと呼ばれる) を介して継続的に更新を受け取るコンポーネントおよび開発ツールは、API 階層 3 とみなされます。開発者は注意を払い、これらのコンポーネントがマイナーリリースごとにどのように変化するかを理解する必要があります。コンポーネント別に文書化されている互換性ガイドラインを参照することが推奨されます。
API 階層 4
互換性は提供されません。API および AOE はいつでも変更できます。これらの機能は、長期サポートを必要とするアプリケーションで使用できません。
Operator がタスクを実行するためにカスタムリソース定義 (CRD) を内部で使用する方法は一般的な方法です。これらのオブジェクトは、Operator に含まれない外部アクターが使用するためのものではなく、非表示にすることを意図しています。CRD が Operator の外部のアクターが使用することを意図していない場合は、Operator ClusterServiceVersion (CSV) の operators.operatorframework.io/internal-objects アノテーションを指定して、対応するリソースが内部使用のみであることを通知する必要があります。また、CRD は、明示的に階層 4 としてラベル付けできます。
