第1章 API ティアについて


重要

このガイダンスでは、階層化された Red Hat build of MicroShift オファリングは説明しません。

Red Hat をお使いのアプリケーション開発者は、未特定の実装に特有の動作への依存や、特定の API 実装におけるバグへの依存を防ぐために、アプリケーション開発者が依存する動作が、API の公式ドキュメントで明示的に定義されていることを確認することが求められます。たとえば、入力ルーターの新しいリリースは、アプリケーションで、文書化されていない API を使用するか、未定義の動作に依存している場合に、古いリリースとは互換性がない場合があります。

1.1. API ティア

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

API ティア 1

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

API ティア 2

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

API ティア 3

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

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

API ティア 4

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

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

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.