CLI 命令示例

ibmcloud resource service-instance-update "Event Streams resource instance name" -p '{"mirroring":{"source_crn":"<source_crn>", "source_alias":"<source_alias>", "target_alias":"<target_alias>"}}'

选择要镜像的主题

服务实例更新完成后，您必须选择将从源集群镜像到目标集群的主题。 使用CLI的“ibmcloud es mirroring-topic-selection-set”命令即可完成此操作。 任何习惯从这些选定主题进行消费的消费者群体，都将从源群映射到目标群。 主题选择的格式为正则表达式模式或此类模式的逗号分隔列表。

以下命令选择要镜像的所有主题:

ibmcloud es mirroring-topic-selection-set --select '.*'

您可以通过列出要镜像的主题来选择主题，如下所示:

ibmcloud es mirroring-topic-selection-set --select topic1,topic2,topic3

有关进行选择的更多信息，请参阅 镜像用户控件。

选择完主题后，目标集群将显示使用镜像用户控件 （后缀为源集群的别名）所选用于镜像的主题。

步骤 3.1: 指定主题和组名称的转换方式

您可以指定转换规则，将数据镜像到目标集群中具有不同名称的主题中。 以下三种情况描述了可能的转变，并解释了每种情况的使用案例。

启用镜像后，您可以随时指定镜像哪些主题或消费者群体，但主题或群体转换只能在启用镜像时进行。 如果镜像功能已经启用，则需要在发出后续启用请求以指定主题或群组转换之前先将其禁用。

场景1：通过删除旧的前缀或后缀并添加新的前缀或后缀来转换主题

配置以下四个附加参数。

| 主题重命名所需的参数 | 说明 | 主题重命名所需的参数 | -- | -- | | remove_prefix | 要从源群集主题名称中删除的前缀 | remove_suffix | 要从源群集的主题名称中删除的后缀 | add_prefix | 要添加到目标群集主题名称中的前缀 | add_suffix | 要添加到目标群组中主题名称的后缀

ibmcloud resource service-instance-update 命令需要通过 -p 命令行参数指定。 当指定这些选项时，只有前缀或后缀匹配的主题才有资格进行镜像。 例如，如果您有一个 remove_prefix 的 app1-，并指定一个主题选择 abc.*，则只有以 app1-abc 开头的主题才会被镜像。

如果您指定了“重命名”类型的转换，但没有指定 add_prefix 或 add_suffix 的参数，则目标集群中的镜像主题将删除这些参数。 在删除任何源前缀或后缀后，以及在添加任何前缀或后缀前，主题模式会应用到主题名称。

请参阅以下 CLI 命令示例：

{
  "mirroring": {
    "source_crn": "crn:v1:...",
    "source_alias": "source",
    "target_alias": "target",
    "options": {
      "topic_name_transform": {
        "type": "rename",
        "rename": {
          "add_prefix": "newprefix-",
          "remove_prefix": "oldprefix-",
          "add_suffix": "-newsuffix",
          "remove_suffix": "-oldsuffix"
        }
      }
    }
  }
}

方案 2：将源别名作为后缀添加到镜像主题中

应用主题名称转换，并将 topic_name_transform 类型设为 use_alias。 使用此配置后，源群集中名为 app1-topic 的主题将被镜像到目标群集中名为 app1-topic.source 的主题，因为配置中指定的源别名是 source。

请参阅以下 CLI 命令示例：

{
  "mirroring": {
    "source_crn": "crn:v1:...",
    "source_alias": "source",
    "target_alias": "target",
    "options": {
        "topic_name_transform": {
            "type": "use_alias"
      }
    }
  }
}

情景 3：主题被镜像，名称保持不变

在这种情况下，您还需要将 topic_name_transform 的类型设置为 none。 使用此配置，源集群中名为 app1-topic 的主题将镜像到目标集群中名为 app1-topic 的主题。

请参阅以下 CLI 命令示例：

{
  "mirroring": {
    "source_crn": "crn:v1:...",
    "source_alias": "source",
    "target_alias": "target",
    "options": {
        "topic_name_transform": {
            "type": "none"
      }
    }
  }
}

步骤 3.2: 转换相应的消费者群体ID

默认情况下，Mirror Maker在镜像到目标集群时不会修改消费者组ID。 然而，Event Streams 允许您修改群组ID的数据，如下面的两种情况所示。 与主题类似，在删除任何源前缀或后缀后，以及在添加任何前缀或后缀前，都会应用组ID模式。 如果您指定了“重命名”类型的转换，但没有指定 add_prefix 或 add_suffix 的参数，则目标集群中的镜像组ID将删除这些参数。

ibmcloud resource service-instance-update 命令需要通过 -p 命令行参数指定。

场景1：通过删除旧的前缀或后缀并添加新的前缀或后缀来转换组ID

配置以下四个附加参数。

| 重命名组 ID 的必要参数 | 说明 | 重命名组 ID 的必要参数 | -- | -- | | remove_prefix | 要从源群集的组 ID 中删除的前缀 | remove_suffix | 要从源群组 ID 中删除的后缀 | add_prefix | 要添加到目标群集组 ID 的前缀 | add_suffix | 要添加到目标群组 ID 的后缀

当指定这些选项时，只有具有匹配前缀或后缀的组ID才有资格进行镜像。 例如，如果您有一个 remove_prefix，aaa 和 add_prefix，bbb，那么源集群中以 aaa-group-id 开头的消费者群组将映射到目标集群中的 bbb-group-id。

请参阅以下 CLI 命令示例：

{
  "group_id_transform": {
    "type": "rename",
    "rename": {
       "add_prefix": "newprefix-",
       "remove_prefix": "oldprefix-",
       "add_suffix": "-newsuffix",
       "remove_suffix": "-oldsuffix"
    }
  }
}

方案 2：消费者组 ID 被镜像，名称不变

在这种情况下，您还需要将 topic_name_transform 的类型设置为 none。 使用此配置，源集群中名为 aaa-group-id 的主题将镜像到目标集群中名为 aaa-group-id 的主题。

请参阅以下 CLI 命令示例：

"group_id_transform": {
  "type": "none"
}