升级 Apache Kafka 版本 - Amazon Managed Streaming for Apache Kafka
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

升级 Apache Kafka 版本

你可以将现有的 MSK 集群升级到更新版本的 Apache Kafka。

注意

  • 您无法将现有 MSK 集群从 ZooKeeper基于 Apache Kafka 的版本升级到使用或需要模式的较新版本。 KRaft 相反，要升级您的集群，请创建一个 KRaft支持的 Kafka 版本的新 MSK 集群，然后将您的数据和工作负载从旧集群迁移。

  • Amazon MSK 仅升级服务器软件。它不会升级您的客户端。

  • 你无法将现有 MSK 集群降级到旧版本的 Apache Kafka。

在升级 MSK 集群的 Apache Kafka 版本时，还要检查您的客户端软件，确保其版本允许您使用集群新 Apache Kafka 版本的功能。

有关如何在升级期间使集群具有高可用性的信息，请参阅构建高度可用的集群。

使用升级 Apache Kafka 版本 Amazon Web Services Management Console

  1. 在 https://console.amazonaws.cn/msk/ 打开 Amazon MSK 控制台。

  2. 在导航栏中，选择您创建 MSK 集群的区域。

  3. 选择要升级的 MSK 集群。

  4. 在 “属性” 选项卡上，在 “Apache Kafka 版本” 部分中选择 “升级”。

  5. 在 Apache Kafka 版本部分中，执行以下操作：

    1. 在 “选择 Apache Kafka 版本” 下拉列表中，选择要升级到的版本。例如，选择 3.9.x。

    2. （可选）选择版本兼容性以查看集群的当前版本与要升级到的版本之间的兼容性。然后，选择 “选择” 继续，或者选择 “取消”。

    3. 选中 “更新集群配置” 复选框可自动应用与升级版本兼容的新 Kafka 配置修订版。这样可以确保兼容性，并支持升级版本的新功能或改进。但是，如果您想保留现有的自定义配置，请跳过它。

    4. 选择 Upgrade。

使用升级 Apache Kafka 版本 Amazon CLI

  1. 运行以下命令，并将 ClusterArn 替换为创建集群时所获取的 Amazon 资源名称（ARN）。如果您没有该集群的 ARN，可以通过列出所有集群来找到它。有关更多信息，请参阅 列出 Amazon MSK 集群。

    aws kafka get-compatible-kafka-versions --cluster-arn ClusterArn

    此命令的输出包括您可以将集群升级到的 Apache Kafka 版本列表。其内容类似于以下示例。

    {
    "CompatibleKafkaVersions": [
        {
            "SourceVersion": "2.2.1",
            "TargetVersions": [
                "2.3.1",
                "2.4.1",
                "2.4.1.1",
                "2.5.1"
            ]
        }
    ]
}

  2. 运行以下命令，并将 ClusterArn 替换为创建集群时所获取的 Amazon 资源名称（ARN）。如果您没有该集群的 ARN，可以通过列出所有集群来找到它。有关更多信息，请参阅 列出 Amazon MSK 集群。

    将 Current-Cluster-Version 替换为集群的当前版本。因为TargetVersion你可以从上一个命令的输出中指定任何目标版本。

    重要

    集群版本不是简单的整数。要查找集群的当前版本，请使用DescribeCluster操作或 desc ribe- Amazon CLI cluster 命令。示例版本是 KTVPDKIKX0DER。

    aws kafka update-cluster-kafka-version --cluster-arn ClusterArn --current-version Current-Cluster-Version --target-kafka-version TargetVersion

    上一个命令的输出如以下 JSON 所示。

    {
    
    "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
    "ClusterOperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef"
}

  3. 要获得update-cluster-kafka-version操作结果，请运行以下命令，ClusterOperationArn替换为在命令输出中获得的 ARN。update-cluster-kafka-version

    aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn

    该 describe-cluster-operation 命令的输出如以下 JSON 示例所示。

    {
    "ClusterOperationInfo": {
        "ClientRequestId": "62cd41d2-1206-4ebf-85a8-dbb2ba0fe259",
        "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
        "CreationTime": "2021-03-11T20:34:59.648000+00:00",
        "OperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef",
        "OperationState": "UPDATE_IN_PROGRESS",
        "OperationSteps": [
            {
                "StepInfo": {
                    "StepStatus": "IN_PROGRESS"
                },
                "StepName": "INITIALIZE_UPDATE"
            },
            {
                "StepInfo": {
                    "StepStatus": "PENDING"
                },
                "StepName": "UPDATE_APACHE_KAFKA_BINARIES"
            },
            {
                "StepInfo": {
                    "StepStatus": "PENDING"
                },
                "StepName": "FINALIZE_UPDATE"
            }
        ],
        "OperationType": "UPDATE_CLUSTER_KAFKA_VERSION",
        "SourceClusterInfo": {
            "KafkaVersion": "2.4.1"
        },
        "TargetClusterInfo": {
            "KafkaVersion": "2.6.1"
        }
    }
}

    如果 OperationState 的值为 UPDATE_IN_PROGRESS，请等待一段时间，然后再次运行 describe-cluster-operation 命令。操作完成后，OperationState 的值变为 UPDATE_COMPLETE。由于 Amazon MSK 完成操作所需的时间各不相同，您可能需要反复检查直到操作完成。

使用 API 升级 Apache Kafka 版本

  1. 调用该GetCompatibleKafkaVersions操作以获取您可以将集群升级到的 Apache Kafka 版本列表。

  2. 调用该UpdateClusterKafkaVersion操作将集群升级到兼容的 Apache Kafka 版本之一。