升级与可能的兼容性问题总结

Mon, 01 Jan 0001 00:00:00 +0000

环境要求：需要Java 8及以上版本。

2.7.0版本在改造的过程中遵循了一个原则，即保持与低版本的兼容性，因此从功能层面来说它是与2.6.x及更低版本完全兼容的，而接下来将要提到的兼容性问题主要是包重命名带来的。另外，虽然功能用法保持向后兼容，但参考本文能帮助您尽快用到2.7.0版本的新特性。

升级步骤

升级pom到2.7.0（以all-in-one依赖为例）。

<properties>
 <dubbo.version>2.7.0</dubbo.version>
</properties>
<dependencyManagement>
 <dependencies>
 <dependency>
 <groupId>org.apache.dubbo</groupId>
 <artifactId>dubbo-dependencies-bom</artifactId>
 <version>${dubbo.version}</version>
 <type>pom</type>
 <scope>import</scope>
 </dependency>
 </dependencies>
</dependencyManagement>

<dependencies>
 <dependency>
 <groupId>org.apache.dubbo</groupId>
 <artifactId>dubbo</artifactId>
 <version>${dubbo.version}</version>
 </dependency>
 <dependency>
 <groupId>io.netty</groupId>
 <artifactId>netty-all</artifactId>
 </dependency>
</dependencies>

如果升级依赖后出现API或SPI扩展相关的编译错误，请参考包兼容性问题

此时重新部署应用，所有默认行为和2.6.x保持一致，如果要用到2.7的新特性，则需要继续做以下配置（可选）：

简化的URL
配置元数据中心
使用外部化配置
服务治理规则
使用异步API

下面我们就对这几部分的配置分别做详细说明。

简化的URL

<!-- simplified="true"表示注册简化版的URL到Registry -->
<dubbo:registry address="zookeeper://127.0.0.1:2181" simplified="true"/>

dubbo.registry.simplified=true

建议将此配置集中管理，参考外部化配置。

URL简化只是剔除了一些纯粹的查询用的参数，并没有做大刀阔斧的服务发现模型改造，因此精简后的URL完全可以被2.6及以下版本的消费端实现服务发现与调用，同样2.7版本也可以发现和调用低版本的提供者。

配置元数据中心

<dubbo:metadata-report address="redis://127.0.0.1:6379"/>

dubbo.metadataReport.address=redis://127.0.0.1:6379

建议将此配置集中管理，参考外部化配置。在此了解更多元数据中心设计目的与用途。

使用外部化配置

需要在项目启动前，使用[最新版本Dubbo-OPS](https://github.com/apache/dubbo-ops)完成外部化配置迁移，理论上配置中心支持所有本地dubbo.properties所支持的配置项。

以XML开发形式为例，假设我们本地有如下配置：

<dubbo:application name="demo-provider"/>
<dubbo:config-center address="zookeeper://127.0.0.1:2181"/>

<dubbo:registry address="zookeeper://127.0.0.1:2181" simplified="true"/>
<dubbo:metadata-report address="redis://127.0.0.1:6379"/>
<dubbo:protocol name="dubbo" port="20880"/>

<bean id="demoService" class="org.apache.dubbo.samples.basic.impl.DemoServiceImpl"/>
<dubbo:service interface="org.apache.dubbo.samples.basic.api.DemoService" ref="demoService"/>

通过OPS控制台将以下全局配置迁移到配置中心，成为所有应用共享的配置。

版本升级 on Apache Dubbo

升级与可能的兼容性问题总结

升级步骤

简化的URL

配置元数据中心

使用外部化配置