本文说明如何升级云消息队列 Kafka 版实例的版本。

前提条件

云消息队列 Kafka 版实例的状态为服务中。

背景信息

  • 升级大版本

    升级大版本是指跨版本升级，例如将云消息队列 Kafka 版实例的版本从0.10.x版本升级至2.x版本。

    重要
    • 云消息队列 Kafka 版实例支持0.10.x和2.x大版本。其中，0.10.x大版本提供0.10版本和0.10.2版本，2.x大版本只提供2.2.0版本。
    • 由于2.x版本的消息存储格式与0.10.x版本不同，您在完成升级之后，将无法回退到0.10.x版本，请您谨慎操作。
  • 升级小版本
    升级小版本是指非跨版本升级，例如将云消息队列 Kafka 版实例的版本从0.10版本升级至0.10.2版本，或者从0.10.2版本升级至0.10.2内核优化版。
    重要 0.10版本有一定概率触发死锁、频繁Rebalance等问题，建议您将0.10版本升级至0.10.2版本。如何升级，请参见升级小版本。

注意事项

  • 升级不会收取任何费用，且该升级兼容现运行的SDK和OpenAPI。
  • 为保证升级过程中业务不受影响，请确保客户端支持重连机制（默认支持）及对断开连接的异常处理。
  • 建议您先购买测试实例进行升级验证，再到生产实例进行操作。
  • 建议您在业务低峰期执行升级操作。
  • 升级大版本后请更新客户端版本，保持客户端和服务端版本一致，升级小版本无需更新客户端版本。
  • 升级大版本持续时间取决于实例规模，一般情况下，节点数量越多，持续时间越长，正常规模的实例预计持续约25分钟。在升级过程中，会对节点逐个进行升级，单个节点升级完成后会观察一段时间继续对下个节点进行升级，服务不会中断，正常情况下不会影响业务。
  • 升级小版本持续时间取决于实例规模，一般情况下，节点数量越多，持续时间越长，正常规模的实例预计持续约15分钟。在升级过程中，会对节点逐个进行升级，单个节点升级完成后会观察一段时间继续对下个节点进行升级，服务不会中断，正常情况下不会影响业务。

升级大版本

  1. 登录云消息队列 Kafka 版控制台，在概览页面的资源分布区域，选择地域。
  2. 在实例列表页面，单击目标实例名称。
  3. 在实例详情页面的基础信息区域，单击大版本右侧的升级大版本。
  4. 在升级实例大版本面板，完成以下操作：
    1. 认真阅读升级必读！中的内容。
    2. 在紧急联系人文本框，输入您的姓名。
    3. 在紧急联系电话文本框，输入您的紧急联系电话。
    4. 在执行时间中选择需执行的时间。
    5. 单击确定。
      说明

升级小版本

  1. 登录云消息队列 Kafka 版控制台，在概览页面的资源分布区域，选择地域。
  2. 在实例列表页面，单击目标实例名称。
  3. 在实例详情页面的基础信息区域，单击小版本右侧的升级小版本。
  4. 在升级实例小版本面板，完成以下操作：
    1. 认真阅读升级必读！中的内容。
    2. 在紧急联系人文本框，输入您的姓名。
    3. 在紧急联系电话文本框，输入您的紧急联系电话。
    4. 在执行时间中选择需执行的时间。
    5. 单击确定。
      说明