10.6. Kafka トピックに影響を与えずに KafkaTopic リソースを管理する


この手順では、現在 KafkaTopic リソースを通じて管理されている Kafka トピックを非管理トピックに変換する方法について説明します。この機能はさまざまなシナリオで役立ちます。たとえば、KafkaTopic リソースの metadata.name を更新したい場合があります。これを行うには、元の KafkaTopic リソースを削除し、新しいリソースを再作成する必要があります。

KafkaTopic リソースに strimzi.io/managed=false のアノテーションを付けることにより、Topic Operator がその特定のトピックを管理すべきでないことを示します。これにより、リソースの設定やその他の管理タスクを変更しながら、Kafka トピックを保持できるようになります。

一方向トピック管理を使用している場合は、このタスクを実行できます。

手順

  1. OpenShift で KafkaTopic リソースにアノテーションを付け、strimzi.io/managedfalse に設定します。

    oc annotate kafkatopic my-topic-1 strimzi.io/managed="false"

    KafkaTopic リソース内のトピックの metadata.name を指定します。この例では my-topic-1 です。

  2. KafkaTopic リソースのステータスをチェックして、リクエストが成功したことを確認します。

    oc get kafkatopics my-topic-1 -o yaml

    Ready ステータスのトピックの例

    apiVersion: kafka.strimzi.io/v1beta2
    kind: KafkaTopic
    metadata:
      generation: 124
      name: my-topic-1
      finalizer:
        strimzi.io/topic-operator
      labels:
        strimzi.io/cluster: my-cluster
    spec:
      partitions: 10
      replicas: 2
    
    # ...
    status:
      observedGeneration: 124 1
      topicName: my-topic-1
      conditions:
      - type: Ready
        status: True
        lastTransitionTime: 20230301T103000Z

    1
    リソースの調整が成功すると、トピックは管理されなくなります。

    metadata.generation (デプロイの現在のバージョン) の値は、status.observedGeneration (リソースの最新の調整) と一致する必要があります。

  3. これで、管理していた Kafka トピックに影響を与えることなく、KafkaTopic リソースを変更できるようになりました。

    たとえば、metadata.name を変更するには、次のように実行します。

    1. 元の KafkTopic リソースを削除します。

      oc delete kafkatopic <kafka_topic_name>
    2. 別の metadata.name を使用して KafkTopic リソースを再作成しますが、元のリソースで管理されていたのと同じトピックを参照するには spec.topicName を使用します。
  4. 元の KafkaTopic リソースを削除していないが、Kafka トピックの管理を再度再開したい場合は、strimzi.io/managed アノテーションを true に設定するか、アノテーションを削除します。
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

© 2024 Red Hat, Inc.