2.3. v1beta2 API バージョンのサポート
すべてのカスタムリソースの v1beta2 API バージョンが、Streams for Apache Kafka 1.7 で導入されました。Streams for Apache Kafka 1.8 で、KafkaTopic と KafkaUser を除くすべての Streams for Apache Kafka カスタムリソースから v1alpha1 および v1beta1 API バージョンが削除されました。
カスタムリソースを v1beta2 にアップグレードすると、Kubernetes 1.22 に必要な Kubernetes CRD v1 へ移行する準備ができます。
バージョン 1.7 より前の Streams for Apache Kafka バージョンからアップグレードする場合は、以下を行います。
- Streams for Apache Kafka 1.7 へのアップグレード
-
カスタムリソースの
v1beta2への変換 - Streams for Apache Kafka 1.8 へのアップグレード
Streams for Apache Kafka バージョン 2.7 にアップグレードする前に、API バージョン v1beta2 を使用するようにカスタムリソースをアップグレードする必要があります。
2.3.1. カスタムリソースの v1beta2 へのアップグレード
カスタムリソースの v1beta2 へのアップグレードをサポートするために、Streams for Apache Kafka には API 変換ツール が用意されています。このツールは、Streams for Apache Kafka 1.8 ソフトウェアダウンロードページ からダウンロードできます。
カスタムリソースは、手順 2 つでアップグレードします。
ステップ 1: カスタムリソースの形式への変換
API 変換ツールを使用して、以下のいずれかの方法でカスタムリソースの形式を v1beta2 に適用可能な形式に変換できます。
- Streams for Apache Kafka カスタムリソースの設定を記述した YAML ファイルの変換
- クラスターでの Streams for Apache Kafka カスタムリソースの直接変換
各カスタムリソースを、v1beta2 に適用可能な形式に手動で変換することもできます。カスタムリソースを手動で変換する手順は、ドキュメントを参照してください。
ステップ 2: CRD の v1beta2 へのアップグレード
次に、crd-upgrade コマンドで API 変換ツールを使用して、CRD の ストレージ API バージョンとして v1beta2 を設定する必要があります。この手順は手動で行うことはできません。
詳細は、1.7 より前のバージョンの Streams for Apache Kafka からアップグレードする を参照してください。
