ホーム
製品
Red Hat AMQ
7.4
Using AMQ Streams on OpenShift Container Platform
Chapter 10. AMQ Streams resource upgrades

このコンテンツは選択した言語では利用できません。

Chapter 10. AMQ Streams resource upgrades

For this release of AMQ Streams, resources that use the API version kafka.strimzi.io/v1alpha1 must be updated to use kafka.strimzi.io/v1beta1.

The kafka.strimzi.io/v1alpha1 API version is deprecated in release 1.2.

This section describes the upgrade steps for the resources.

Important

The upgrade of resources must be performed after upgrading the Cluster Operator, so the Cluster Operator can understand the resources.

What if the resource upgrade does not take effect?

If the upgrade does not take effect, a warning is given in the logs on reconciliation to indicate that the resource cannot be updated until the apiVersion is updated.

To trigger the update, make a cosmetic change to the custom resource, such as adding an annotation.

Example annotation:

metadata:
  # ...
  annotations:
    upgrade: "Upgraded to kafka.strimzi.io/v1beta1"

metadata:
  # ...
  annotations:
    upgrade: "Upgraded to kafka.strimzi.io/v1beta1"

Copy to Clipboard

10.1. Upgrading Kafka resources

Prerequisites

A Cluster Operator supporting the v1beta1 API version is up and running.

Procedure

Execute the following steps for each Kafka resource in your deployment.

Update the Kafka resource in an editor.
```
oc edit kafka my-cluster
```
```
oc edit kafka my-cluster
```
Copy to Clipboard

Replace:

apiVersion: kafka.strimzi.io/v1alpha1

apiVersion: kafka.strimzi.io/v1alpha1

Copy to Clipboard

with:

apiVersion:kafka.strimzi.io/v1beta1

apiVersion:kafka.strimzi.io/v1beta1

Copy to Clipboard

If the Kafka resource has:

Kafka.spec.topicOperator

Kafka.spec.topicOperator

Copy to Clipboard

Replace it with:

Kafka.spec.entityOperator.topicOperator

Kafka.spec.entityOperator.topicOperator

Copy to Clipboard

For example, replace:

spec:
  # ...
  topicOperator: {}

spec:
  # ...
  topicOperator: {}

Copy to Clipboard

with:

spec:
  # ...
  entityOperator:
    topicOperator: {}

spec:
  # ...
  entityOperator:
    topicOperator: {}

Copy to Clipboard

If present, move:

Kafka.spec.entityOperator.affinity

Kafka.spec.entityOperator.affinity

Copy to Clipboard

Kafka.spec.entityOperator.tolerations

Kafka.spec.entityOperator.tolerations

Copy to Clipboard

to:

Kafka.spec.entityOperator.template.pod.affinity

Kafka.spec.entityOperator.template.pod.affinity

Copy to Clipboard

Kafka.spec.entityOperator.template.pod.tolerations

Kafka.spec.entityOperator.template.pod.tolerations

Copy to Clipboard

For example, move:

spec:
  # ...
  entityOperator:
    affinity {}
    tolerations {}

spec:
  # ...
  entityOperator:
    affinity {}
    tolerations {}

Copy to Clipboard

to:

spec:
  # ...
  entityOperator:
    template:
      pod:
        affinity {}
        tolerations {}

spec:
  # ...
  entityOperator:
    template:
      pod:
        affinity {}
        tolerations {}

Copy to Clipboard

If present, move:

Kafka.spec.kafka.affinity

Kafka.spec.kafka.affinity

Copy to Clipboard

Kafka.spec.kafka.tolerations

Kafka.spec.kafka.tolerations

Copy to Clipboard

to:

Kafka.spec.kafka.template.pod.affinity

Kafka.spec.kafka.template.pod.affinity

Copy to Clipboard

Kafka.spec.kafka.template.pod.tolerations

Kafka.spec.kafka.template.pod.tolerations

Copy to Clipboard

For example, move:

spec:
  # ...
  kafka:
    affinity {}
    tolerations {}

spec:
  # ...
  kafka:
    affinity {}
    tolerations {}

Copy to Clipboard

to:

spec:
  # ...
  kafka:
    template:
      pod:
        affinity {}
        tolerations {}

spec:
  # ...
  kafka:
    template:
      pod:
        affinity {}
        tolerations {}

Copy to Clipboard

If present, move:

Kafka.spec.zookeeper.affinity

Kafka.spec.zookeeper.affinity

Copy to Clipboard

Kafka.spec.zookeeper.tolerations

Kafka.spec.zookeeper.tolerations

Copy to Clipboard

to:

Kafka.spec.zookeeper.template.pod.affinity

Kafka.spec.zookeeper.template.pod.affinity

Copy to Clipboard

Kafka.spec.zookeeper.template.pod.tolerations

Kafka.spec.zookeeper.template.pod.tolerations

Copy to Clipboard

For example, move:

spec:
  # ...
  zookeeper:
    affinity {}
    tolerations {}

spec:
  # ...
  zookeeper:
    affinity {}
    tolerations {}

Copy to Clipboard

to:

spec:
  # ...
  zookeeper:
    template:
      pod:
        affinity {}
        tolerations {}

spec:
  # ...
  zookeeper:
    template:
      pod:
        affinity {}
        tolerations {}

Copy to Clipboard

Save the file, exit the editor and wait for the updated resource to be reconciled.

10.2. Upgrading Kafka Connect resources

Prerequisites

A Cluster Operator supporting the v1beta1 API version is up and running.

Procedure

Execute the following steps for each KafkaConnect resource in your deployment.

Update the KafkaConnect resource in an editor.
```
oc edit kafkaconnect my-connect
```
```
oc edit kafkaconnect my-connect
```
Copy to Clipboard

Replace:

apiVersion: kafka.strimzi.io/v1alpha1

apiVersion: kafka.strimzi.io/v1alpha1

Copy to Clipboard

with:

apiVersion:kafka.strimzi.io/v1beta1

apiVersion:kafka.strimzi.io/v1beta1

Copy to Clipboard

If present, move:

KafkaConnect.spec.affinity

KafkaConnect.spec.affinity

Copy to Clipboard

KafkaConnect.spec.tolerations

KafkaConnect.spec.tolerations

Copy to Clipboard

to:

KafkaConnect.spec.template.pod.affinity

KafkaConnect.spec.template.pod.affinity

Copy to Clipboard

KafkaConnect.spec.template.pod.tolerations

KafkaConnect.spec.template.pod.tolerations

Copy to Clipboard

For example, move:

spec:
  # ...
  affinity {}
  tolerations {}

spec:
  # ...
  affinity {}
  tolerations {}

Copy to Clipboard

to:

spec:
  # ...
  template:
    pod:
      affinity {}
      tolerations {}

spec:
  # ...
  template:
    pod:
      affinity {}
      tolerations {}

Copy to Clipboard

Save the file, exit the editor and wait for the updated resource to be reconciled.

10.3. Upgrading Kafka Connect S2I resources

Prerequisites

A Cluster Operator supporting the v1beta1 API version is up and running.

Procedure

Execute the following steps for each KafkaConnectS2I resource in your deployment.

Update the KafkaConnectS2I resource in an editor.
```
oc edit kafkaconnects2i my-connect
```
```
oc edit kafkaconnects2i my-connect
```
Copy to Clipboard

Replace:

apiVersion: kafka.strimzi.io/v1alpha1

apiVersion: kafka.strimzi.io/v1alpha1

Copy to Clipboard

with:

apiVersion:kafka.strimzi.io/v1beta1

apiVersion:kafka.strimzi.io/v1beta1

Copy to Clipboard

If present, move:

KafkaConnectS2I.spec.affinity

KafkaConnectS2I.spec.affinity

Copy to Clipboard

KafkaConnectS2I.spec.tolerations

KafkaConnectS2I.spec.tolerations

Copy to Clipboard

to:

KafkaConnectS2I.spec.template.pod.affinity

KafkaConnectS2I.spec.template.pod.affinity

Copy to Clipboard

KafkaConnectS2I.spec.template.pod.tolerations

KafkaConnectS2I.spec.template.pod.tolerations

Copy to Clipboard

For example, move:

spec:
  # ...
  affinity {}
  tolerations {}

spec:
  # ...
  affinity {}
  tolerations {}

Copy to Clipboard

to:

spec:
  # ...
  template:
    pod:
      affinity {}
      tolerations {}

spec:
  # ...
  template:
    pod:
      affinity {}
      tolerations {}

Copy to Clipboard

Save the file, exit the editor and wait for the updated resource to be reconciled.

10.4. Upgrading Kafka Mirror Maker resources

Prerequisites

A Cluster Operator supporting the v1beta1 API version is up and running.

Procedure

Execute the following steps for each KafkaMirrorMaker resource in your deployment.

Update the KafkaMirrorMaker resource in an editor.
```
oc edit kafkamirrormaker my-connect
```
```
oc edit kafkamirrormaker my-connect
```
Copy to Clipboard

Replace:

apiVersion: kafka.strimzi.io/v1alpha1

apiVersion: kafka.strimzi.io/v1alpha1

Copy to Clipboard

with:

apiVersion:kafka.strimzi.io/v1beta1

apiVersion:kafka.strimzi.io/v1beta1

Copy to Clipboard

If present, move:

KafkaConnectMirrorMaker.spec.affinity

KafkaConnectMirrorMaker.spec.affinity

Copy to Clipboard

KafkaConnectMirrorMaker.spec.tolerations

KafkaConnectMirrorMaker.spec.tolerations

Copy to Clipboard

to:

KafkaConnectMirrorMaker.spec.template.pod.affinity

KafkaConnectMirrorMaker.spec.template.pod.affinity

Copy to Clipboard

KafkaConnectMirrorMaker.spec.template.pod.tolerations

KafkaConnectMirrorMaker.spec.template.pod.tolerations

Copy to Clipboard

For example, move:

spec:
  # ...
  affinity {}
  tolerations {}

spec:
  # ...
  affinity {}
  tolerations {}

Copy to Clipboard

to:

spec:
  # ...
  template:
    pod:
      affinity {}
      tolerations {}

spec:
  # ...
  template:
    pod:
      affinity {}
      tolerations {}

Copy to Clipboard

Save the file, exit the editor and wait for the updated resource to be reconciled.

10.5. Upgrading Kafka Topic resources

Prerequisites

A Topic Operator supporting the v1beta1 API version is up and running.

Procedure

Execute the following steps for each KafkaTopic resource in your deployment.

Update the KafkaTopic resource in an editor.
```
oc edit kafkatopic my-topic
```
```
oc edit kafkatopic my-topic
```
Copy to Clipboard

Replace:

apiVersion: kafka.strimzi.io/v1alpha1

apiVersion: kafka.strimzi.io/v1alpha1

Copy to Clipboard

with:

apiVersion:kafka.strimzi.io/v1beta1

apiVersion:kafka.strimzi.io/v1beta1

Copy to Clipboard

Save the file, exit the editor and wait for the updated resource to be reconciled.

10.6. Upgrading Kafka User resources

Prerequisites

A User Operator supporting the v1beta1 API version is up and running.

Procedure

Execute the following steps for each KafkaUser resource in your deployment.

Update the KafkaUser resource in an editor.
```
oc edit kafkauser my-user
```
```
oc edit kafkauser my-user
```
Copy to Clipboard

Replace:

apiVersion: kafka.strimzi.io/v1alpha1

apiVersion: kafka.strimzi.io/v1alpha1

Copy to Clipboard

with:

apiVersion:kafka.strimzi.io/v1beta1

apiVersion:kafka.strimzi.io/v1beta1

Copy to Clipboard

Save the file, exit the editor and wait for the updated resource to be reconciled.

トップに戻る

このコンテンツは選択した言語では利用できません。

Chapter 10. AMQ Streams resource upgrades

10.1. Upgrading Kafka resources

10.2. Upgrading Kafka Connect resources

10.3. Upgrading Kafka Connect S2I resources

10.4. Upgrading Kafka Mirror Maker resources

10.5. Upgrading Kafka Topic resources

10.6. Upgrading Kafka User resources

詳細情報

試用、購入および販売

コミュニティー

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

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

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links