升级到triple协议

本文档适合服务已经运行在 dubbo 协议之上的老用户，请先参考上一篇文档 如何从 Dubbo2 升级到 Dubbo3 完成框架版本升级，然后遵循以下步骤以最小改动平滑迁移到 triple 协议。

以下是协议升级的架构图，展示了平滑升级过程中不同 Dubbo 应用的状态：

按先后顺序，升级基本步骤如下：

1. Provider 提供者侧配置单端口双协议（dubbo、triple）发布
2. Provider 提供者侧配置首选协议为 triple（此时，提供者注册的URL地址为 dubbo://host:port/DemoService?preferred-protocol=tri）
3. Consumer 消费者升级，根据情况不同有以下两种方式：
   • 升级消费者到 3.3 版本，消费者会根据 preferred-protocol=tri 优先调用 triple 协议
   • 无法升级到 3.3 版本的消费者应用，可以配置 @DubboReference(protocol="tri") 调用 triple 协议
4. 推动所有应用升级到最新 Dubbo3 版本，最终所有流量都是 triple 协议

步骤一：提供者双协议发布

假设我们有以下应用配置，即在 20880 端口发布 dubbo 协议：

dubbo:
  protocol:
    name: dubbo
    port: 20880

我们需要增加两个配置项，如下所示：

dubbo:
  protocol:
    name: dubbo
    port: 20880
    ext-protocol: tri
    preferred-protocol: tri

其中，

• ext-protocol: tri 指定在原 20880 端口上额外发布 triple 协议，即单端口双协议发布。
• preferred-protocol: tri 会随注册中心同步到 Consumer 侧，告诉 consumer 优先使用 triple 协议调用

步骤二：消费端切换协议

提供端完成步骤一配置并重启后，消费端根据版本与配置不同，可能处于以下三种状态之一：

1. 消费端是 3.3.0 及之后版本

此类消费端会自动识别提供者 url 上的 preferred-protocol: tri 标记，如果发现此标记，则消费端自动使用 triple 协议调用服务，否则继续使用 dubbo 协议。

2. 消费端是 2.x 或 3.3.0 之前版本

由于低版本 Dubbo 框架不能识别 preferred-protocol: tri 参数，因此这部分消费者不受提供者端多协议发布的任何影响，继续调用 dubbo 协议。

3. 消费端是 2.x 或 3.3.0 之前版本，且额外指定要调用的协议

与第 2 种情况基本一致，只是这时用户可以明确的为某些服务指定使用哪种 rpc 协议，如：

@DubboReference(protocol="tri")
private DemoService demoService;

或者

<dubbo:reference protocol="tri" />

在配置了 protocol="tri" 后，服务的调用会使用 triple 协议。需要注意的是，在配置 protocol="tri" 之前，一定要确保提供端已经发布了 triple 协议支持，否则调用将会失败。

步骤三：完全收敛到triple协议

步骤一、二操作起来非常简单，并且保证了过程平滑，通过单端口双协议、消费端自动切换保证了整个升级过程的平滑。

平滑升级意味着我们要经历一个中间态，即在某一段时间内，集群内 dubbo 协议、triple 协议共存（有些服务间通信是dubbo协议、有些服务间通信是triple协议）。如何才能推进达成终态目标那，即所有服务调用都使用 triple 协议？我们推荐使用以下两种方式达成目标：

• 推进集群内所有 Dubbo 应用都升级到 3.3.x 最新版本，这样消费端就能自动切换到 triple 协议
• 通过 Dubbo 框架的指标埋点，观察某个应用（作为provider）是否仍在处理 dubbo 流量，对这部分应用的上下游进行治理