8.2. AMQ Streams カスタムリソースのアップグレード
AMQ Streams を 1.8 にアップグレードする前に、カスタムリソースが API バージョン v1beta2 を使用していることを確認する必要があります。これは、AMQ Streams 1.7 にアップグレードした後にいつでも実行できますが、AMQ Streams 1.8 以降にアップグレードする前にアップグレードを完了する必要があります。
カスタムリソースを v1beta2 にアップグレードすると、Cluster Operator をアップグレードする前に、Cluster Operator がリソースを認識できるように する必要があります。
カスタムリソースを v1beta2 にアップグレードすると、OpenShift v1.22 に必要な OpenShift CRD v1 に移行するために AMQ Streams が準備されます。
カスタムリソースへの CLI のアップグレード
AMQ Streams では、API 変換ツール とそのリリースアーティファクトが提供されます。
AMQ Streams のダウンロードサイトから ZIP または TAR.GZ をダウンロードできます。ツールを使用するには、そのツールを展開して、bin ディレクトリーで スクリプトを使用します。
その CLI からツールを使用して、カスタムリソースの形式を 2 つの方法のいずれかで v1beta2 に変換できます。
カスタムリソースの変換後に、v 1beta2 を CRD のストレージ API バージョンとして設定する必要があります。
カスタムリソースへの手動アップグレード
API 変換ツールを使用してカスタムリソースを v1beta2 に更新する代わりに、v1beta2 を使用するように各カスタムリソースを手動で更新できます。
他のコンポーネントの設定を含む Kafka カスタムリソースを更新します。
デプロイメントに適用される他のカスタムリソースを更新します。
- 「Kafka Connect リソースの v1beta2 へのアップグレード」
- 「Kafka Connect S2I リソースの v1beta2 へのアップグレード」
- 「Kafka MirrorMaker リソースの v1beta2 へのアップグレード」
- 「Kafka MirrorMaker 2.0 リソースの v1beta2 へのアップグレード」
- 「Kafka Bridge リソースの v1beta2 へのアップグレード」
- 「Kafka User リソースの v1beta2 へのアップグレード」
- 「Kafka Topic リソースの v1beta2 へのアップグレード」
- 「Kafka Connector リソースの v1beta2 へのアップグレード」
- 「Kafka Rebalance リソースの v1beta2 へのアップグレード」
手動の手順では、各カスタムリソースに加えた変更が示されます。これらの変更後に、API 変換ツールを使用して CRD をアップグレードする必要があります。
8.2.1. API のバージョン管理 リンクのコピーリンクがクリップボードにコピーされました!
カスタムリソースは、CRD によって OpenShift に追加された API を使用して編集および制御されます。言い換えると、CRD は Kubernetes API を拡張して、カスタムリソースを作成できるようにします。CRD 自体は OpenShift 内のリソースです。これらの CRD は、OpenShift クラスターにインストールされ、カスタムリソースの API のバージョンを定義します。カスタムリソース API の各バージョンで、そのバージョンの独自のスキーマを定義できます。AMQ Streams Operator を含む OpenShift クライアントは、API バージョンが含まれる URL パス (API パス) を使用して Kubernetes API サーバーによって提供されるカスタムリソースにアクセスします。
v1beta2 の導入により、カスタムリソースのスキーマが更新されています。v1alpha1 および v1beta1 のバージョンが削除されました。
v1alpha1 API バージョンは、以下の AMQ Streams カスタムリソースには使用されなくなりました。
-
Kafka -
KafkaConnect -
KafkaConnectS2I -
KafkaConnector -
KafkaMirrorMaker -
KafkaMirrorMaker2 -
KafkaTopic -
KafkaUser -
KafkaBridge -
KafkaRebalance
v1beta1 API バージョンは、以下の AMQ Streams カスタムリソースには使用されなくなりました。
-
Kafka -
KafkaConnect -
KafkaConnectS2I -
KafkaMirrorMaker -
KafkaTopic -
KafkaUser