1、Dubbo简介
Apache Dubbo |ˈdʌbəʊ| 是一款高性能、轻量级的开源Java RPC框架,它提供了三大核心能力:面向接口的远程方法调用,智能容错和负载均衡,以及服务自动注册和发现。
dubbo官网 http://dubbo.apache.org/zh-cn/index.html
dubbo基本概念
服务提供者(Provider):暴露服务的服务提供方,服务提供者在启动时,向注册中心注册自己提供的服务。
服务消费者(Consumer):调用远程服务的服务消费方,服务消费者在启动时,向注册中心订阅自己所需的服务,服务消费者,从提供者地址列表中,基于软负载均衡算法,选一台提供者进行调用,如果调用失败,再选另一台调用。
注册中心(Registry):注册中心返回服务提供者地址列表给消费者,如果有变更,注册中心将基于长连接推送变更数据给消费者
监控中心(Monitor):服务消费者和提供者,在内存中累计调用次数和调用时间,定时每分钟发送一次统计数据到监控中心
调用关系说明
-
服务容器负责启动,加载,运行服务提供者。
-
服务提供者在启动时,向注册中心注册自己提供的服务。
-
服务消费者在启动时,向注册中心订阅自己所需的服务。
-
注册中心返回服务提供者地址列表给消费者,如果有变更,注册中心将基于长连接推送变更数据给消费者。
-
服务消费者,从提供者地址列表中,基于软负载均衡算法,选一台提供者进行调用,如果调用失败,再选另一台调用。
-
服务消费者和提供者,在内存中累计调用次数和调用时间,定时每分钟发送一次统计数据到监控中心。
2、dubbo环境搭建
2.1 windows环境下安装
windows - 安装zookeeper
-
下载zookeeper
网址 https://archive.apache.org/dist/zookeeper/zookeeper-3.4.13/ -
解压zookeeper
解压运行zkServer.cmd ,初次运行会报错,没有zoo.cfg配置文件 -
修改zoo.cfg配置文件
将conf下的zoo_sample.cfg复制一份改名为zoo.cfg即可。
注意几个重要位置:
dataDir=./ 临时数据存储的目录(可写相对路径)
clientPort=2181 zookeeper的端口号
修改完成后再次启动zookeeper -
使用zkCli.cmd测试
ls /:列出zookeeper根下保存的所有节点
create –e /atguigu 123:创建一个atguigu节点,值为123
get /atguigu:获取/atguigu节点的值
windows - 安装dubbo-admin管理控制台
dubbo本身并不是一个服务软件。它其实就是一个jar包能够帮你的java程序连接到zookeeper,并利用zookeeper消费、提供服务。所以你不用在Linux上启动什么dubbo服务。
但是为了让用户更好的管理监控众多的dubbo服务,官方提供了一个可视化的监控程序,不过这个监控即使不装也不影响使用。
-
下载dubbo-admin
https://github.com/apache/incubator-dubbo-ops -
进入目录,修改dubbo-admin配置
修改 src\main\resources\application.properties 指定zookeeper地址 -
在项目目录下打包dubbo-admin
mvn clean package -Dmaven.test.skip=true -
运行dubbo-admin
java -jar dubbo-admin-0.0.1-SNAPSHOT.jar
注意:【有可能控制台看着启动了,但是网页打不开,需要在控制台按下ctrl+c即可】
默认使用root/root 登陆
2.2 linux环境下安装
linux - 安装zookeeper
1、安装jdk
- 下载jdk
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
不要使用wget命令获取jdk链接,这是默认不同意,导致下载来的jdk压缩内容错误
-
上传到服务器并解压
-
设置环境变量
/usr/local/java/jdk1.8.0_171文件末尾加入下面配置
-
使环境变量生效&测试JDK
2、安装zookeeper
-
下载zookeeper
网址 https://archive.apache.org/dist/zookeeper/zookeeper-3.4.11/
wget https://archive.apache.org/dist/zookeeper/zookeeper-3.4.11/zookeeper-3.4.11.tar.gz -
解压
-
移动到指定位置并改名为zookeeper
3、开机启动zookeeper
- -复制如下脚本
#!/bin/bash
#chkconfig:2345 20 90
#description:zookeeper
#processname:zookeeper
ZK_PATH=/usr/local/zookeeper
export JAVA_HOME=/usr/local/java/jdk1.8.0_171
case $1 in
start) sh $ZK_PATH/bin/zkServer.sh start;;
stop) sh $ZK_PATH/bin/zkServer.sh stop;;
status) sh $ZK_PATH/bin/zkServer.sh status;;
restart) sh $ZK_PATH/bin/zkServer.sh restart;;
*) echo "require start|stop|status|restart" ;;
esac
-
-把脚本注册为Service
-
-增加权限
4、配置zookeeper
- 初始化zookeeper配置文件
拷贝/usr/local/zookeeper/conf/zoo_sample.cfg
到同一个目录下改个名字叫zoo.cfg
- 启动zookeeper
linux - 安装dubbo-admin管理控制台
1、安装Tomcat8(旧版dubbo-admin是war,新版是jar不需要安装Tomcat)
-
下载Tomcat8并解压
https://tomcat.apache.org/download-80.cgi
wget http://mirrors.shu.edu.cn/apache/tomcat/tomcat-8/v8.5.32/bin/apache-tomcat-8.5.32.tar.gz -
解压移动到指定位置
-
开机启动tomcat8
复制如下脚本
#!/bin/bash
#chkconfig:2345 21 90
#description:apache-tomcat-8
#processname:apache-tomcat-8
CATALANA_HOME=/opt/apache-tomcat-8.5.32
export JAVA_HOME=/opt/java/jdk1.8.0_171
case $1 in
start)
echo "Starting Tomcat..."
$CATALANA_HOME/bin/startup.sh
;;
stop)
echo "Stopping Tomcat..."
$CATALANA_HOME/bin/shutdown.sh
;;
restart)
echo "Stopping Tomcat..."
$CATALANA_HOME/bin/shutdown.sh
sleep 2
echo
echo "Starting Tomcat..."
$CATALANA_HOME/bin/startup.sh
;;
*)
echo "Usage: tomcat {start|stop|restart}"
;; esac
- 注册服务&添加权限
- 启动服务&访问tomcat测试
2、安装dubbo-admin
dubbo本身并不是一个服务软件。它其实就是一个jar包能够帮你的java程序连接到zookeeper,并利用zookeeper消费、提供服务。所以你不用在Linux上启动什么dubbo服务。
但是为了让用户更好的管理监控众多的dubbo服务,官方提供了一个可视化的监控程序,不过这个监控即使不装也不影响使用。
-
下载dubbo-admin
https://github.com/apache/incubator-dubbo-ops -
进入目录,修改dubbo-admin配置
修改 src\main\resources\application.properties 指定zookeeper地址 -
打包dubbo-admin
mvn clean package -Dmaven.test.skip=true -
运行dubbo-admin
java -jar dubbo-admin-0.0.1-SNAPSHOT.jar
默认使用root/root 登陆
3、快速入门dubbo
-
启动zookeeper !
-
IDEA创建一个父项目 dubbo-demo-parent;
-
创建一个模块:服务接口 demo-service(对外提供接口)
-
创建一个模块:实现服务提供者demo-provider
-
创建一个模块:实现服务消费者demo-consumer
3.1 服务接口 demo-service
公共接口层(model,service,exception…)
作用:定义公共接口,也可以导入公共依赖
1.Bean模型
@Data
@TableName(value = "user")
public class User implements Serializable {
private static final long serialVersionUID = -7291508790203233996L;
@TableId(value = "id",type = IdType.AUTO)
private Integer id;
private String name;
private Integer age;
}
2.服务UserService
public interface UserService {
String save(User user);
String sayHello(String word);
}
3.然后使用maven将该模块install到本地仓库,服务提供者和服务消费者的pom中都要引入(相应的数据库配置完成)
3.2 服务提供者demo-provider
1、将服务提供者注册到注册中心,我们需要整合Dubbo和zookeeper,所以需要导包
<!--demo-service 服务接口-->
<dependency>
<groupId>com.example</groupId>
<artifactId>demo-service</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
<!--dubbo-->
<dependency>
<groupId>org.apache.dubbo</groupId>
<artifactId>dubbo-spring-boot-starter</artifactId>
<version>2.7.3</version>
<exclusions>
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.apache.curator</groupId>
<artifactId>curator-framework</artifactId>
<version>4.0.1</version>
</dependency>
<dependency>
<groupId>org.apache.curator</groupId>
<artifactId>curator-recipes</artifactId>
<version>2.8.0</version>
</dependency>
<!--zookeeper-->
<dependency>
<groupId>org.apache.zookeeper</groupId>
<artifactId>zookeeper</artifactId>
<version>3.4.13</version>
<type>pom</type>
<exclusions>
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>com.101tec</groupId>
<artifactId>zkclient</artifactId>
<version>0.10</version>
</dependency>
2.在springboot配置文件中配置dubbo相关属性!
#当前应用名字
dubbo.application.name=demo-provider
#注册中心地址
dubbo.registry.address=zookeeper://127.0.0.1:2181
#扫描指定包下服务
dubbo.scan.base-packages=com.example.demoprovider.service
#registry.protocol 是指定注册中心协议
dubbo.registry.protocol=zookeeper
#protocol.name 是分布式固定是dubbo,不要改。
dubbo.protocol.name=dubbo
3、在service的实现类中配置服务注解,发布服务!注意导包问题
@Service
@Component
public class UserServiceImpl implements UserService {
//@Service、@Reference
//【如果没有在配置中写dubbo.scan.base-package,还需要使用@EnableDubbo注解】
@Resource
private UserMapper userMapper;
@Override
public String save(User user) {
userMapper.insert(user);
return "success";
}
@Override
public String sayHello(String word) {
return "hello "+word;
}
}
4、启动类,添加@EnableDubbo
@SpringBootApplication
@EnableDubbo
@MapperScan("com.example.demoprovider.mapper")
public class DemoProviderApplication {
public static void main(String[] args) {
SpringApplication.run(DemoProviderApplication.class, args);
}
}
3.3 服务消费者demo-consumer
1、导入依赖,和之前的依赖一样
<!--demo-service 服务接口-->
<dependency>
<groupId>com.example</groupId>
<artifactId>demo-service</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
<!--dubbo-->
<dependency>
<groupId>org.apache.dubbo</groupId>
<artifactId>dubbo-spring-boot-starter</artifactId>
<version>2.7.3</version>
<exclusions>
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.apache.curator</groupId>
<artifactId>curator-framework</artifactId>
<version>4.0.1</version>
</dependency>
<dependency>
<groupId>org.apache.curator</groupId>
<artifactId>curator-recipes</artifactId>
<version>2.8.0</version>
</dependency>
<!--zookeeper-->
<dependency>
<groupId>org.apache.zookeeper</groupId>
<artifactId>zookeeper</artifactId>
<version>3.4.13</version>
<type>pom</type>
<exclusions>
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>com.101tec</groupId>
<artifactId>zkclient</artifactId>
<version>0.10</version>
</dependency>
2.在springboot配置文件中配置dubbo相关属性!
#当前应用名字
dubbo.application.name=demo-consumer
#注册中心地址
dubbo.registry.address=zookeeper://127.0.0.1:2181
#扫描指定包下服务
dubbo.scan.base-packages=com.example.demoprovider.service
#registry.protocol 是指定注册中心协议
dubbo.registry.protocol=zookeeper
#protocol.name 是分布式固定是dubbo,不要改。
dubbo.protocol.name=dubbo
3、UserController,消费服务
@RestController
public class UserController {
@Reference //该注解是dubbo提供的
private UserService userService;
@GetMapping("/say/{word}")
public String sayWord(@PathVariable String word) {
return userService.sayHello(word);
}
@GetMapping("/saveUser")
public String save() {
User user = new User();
user.setName("admin");
user.setAge(22);
return userService.save(user);
}
}
4、监控中心
4.1、dubbo-admin
图形化的服务管理页面;安装时需要指定注册中心地址,即可从注册中心中获取到所有的提供者/消费者进行配置管理
4.2、dubbo-monitor-simple
简单的监控中心;
1、安装
-
下载 dubbo-ops
https://github.com/apache/incubator-dubbo-ops -
修改配置指定注册中心地址
进入 dubbo-monitor-simple\src\main\resources\conf
修改 dubbo.properties文件
-
打包dubbo-monitor-simple
mvn clean package -Dmaven.test.skip=true -
解压 tar.gz 文件,并运行start.bat
如果缺少servlet-api,自行导入servlet-api再访问监控中心
- 启动访问8080
2、监控中心配置
所有服务配置连接监控中心,进行监控统计
<!-- 监控中心协议,如果为protocol="registry",表示从注册中心发现监控中心地址,否则直连监控中心 -->
<dubbo:monitor protocol="registry"></dubbo:monitor>
Simple Monitor 挂掉不会影响到 Consumer 和 Provider 之间的调用,所以用于生产环境不会有风险。
Simple Monitor 采用磁盘存储统计信息,请注意安装机器的磁盘限制,如果要集群,建议用mount共享磁盘。
5、常用配置
主要介绍了xml的配置 springboot+properties可以直接在 方法/接口/properties里直接配置
5.1 配置原则
dubbo可以在JVM 启动参数、dubboXML、dubbo.properties 三个地方配置相关属性,这里我们以端口为例.
-
JVM 启动参数
我们可以在启动项目时配置VM参数-Ddubbo.protocol.port=20883
- dubboXML
<dubbo:protocol name="dubbo" port="20882"></dubbo:protocol>
- dubbo.properties
dubbo.protocol.port=20881
覆盖策略
JVM 启动 -D 参数优先,这样可以使用户在部署和启动时进行参数重写,比如在启动时需改变协议的端口。
XML 次之,如果在 XML 中有配置,则 dubbo.properties 中的相应配置项无效。
Properties 最后,相当于缺省值,只有 XML 没有配置时,dubbo.properties 的相应配置项才会生效,通常用于共享公共配置,比如应用名。
配置原则
dubbo推荐在Provider上尽量多配置Consumer端属性:
1、作服务的提供者,比服务使用方更清楚服务性能参数,如调用的超时时间,合理的重试次数,等等
2、在Provider配置后,Consumer不配置则会使用Provider的配置值,即Provider配置可以作为Consumer的缺省值。否则,Consumer会使用Consumer端的全局设置,这对于Provider不可控的,并且往往是不合理的
5.2 配置覆盖原则
以 timeout 为例,显示了配置的查找顺序,其它 retries, loadbalance, actives 等类似
- 方法级优先,接口级次之,全局配置再次之。
- 如果级别一样,则消费方优先,提供方次之。
其中,服务提供方配置,通过 URL 经由注册中心传递给消费方。
建议由服务提供方设置超时,因为一个方法需要执行多长时间,服务提供方更清楚,如果一个消费方同时引用多个服务,就不需要关心每个服务的超时设置。
5.3 重试次数
失败自动切换,当出现失败,重试其它服务器,但重试会带来更长延迟。可通过 retries=“2” 来设置重试次数(不含第一次)。
重试次数配置如下
<dubbo:service retries="2" />
或
<dubbo:reference retries="2" />
或
<dubbo:reference>
<dubbo:method name="findFoo" retries="2" />
</dubbo:reference>
5.4 超时时间
由于网络或服务端不可靠,会导致调用出现一种不确定的中间状态(超时)。为了避免超时导致客户端资源(线程)挂起耗尽,必须设置超时时间。
- Dubbo消费端
全局超时配置
<dubbo:consumer timeout="5000" />
指定接口以及特定方法超时配置
<dubbo:reference interface="com.foo.BarService" timeout="2000">
<dubbo:method name="sayHello" timeout="3000" />
</dubbo:reference>
- Dubbo服务端
全局超时配置
<dubbo:provider timeout="5000" />
指定接口以及特定方法超时配置
<dubbo:provider interface="com.foo.BarService" timeout="2000">
<dubbo:method name="sayHello" timeout="3000" />
</dubbo:provider>
5.5 启动检查
Dubbo 缺省会在启动时检查依赖的服务是否可用,不可用时会抛出异常,阻止 Spring 初始化完成,以便上线时,能及早发现问题,默认 check=“true”。
可以通过 check=“false” 关闭检查,比如,测试时,有些服务不关心,或者出现了循环依赖,必须有一方先启动。
#提供者检查
<dubbo:reference id="userService" interface="com.yz.dubbo.api.IUserService" check="false"></dubbo:reference>
#注册中心检查
<dubbo:registry address="zookeeper://127.0.0.1:2181" check="false"></dubbo:registry>
5.6 版本号
当一个接口实现,出现不兼容升级时,可以用版本号过渡,版本号不同的服务相互间不引用。
可以按照以下的步骤进行版本迁移:
- 在低压力时间段,先升级一半提供者为新版本
- 再将所有消费者升级为新版本
- 然后将剩下的一半提供者升级为新版本
也就实现了dubbo所说的灰度发布
例子
首先我们创建提供者接口两个不同实现
UserServiceImpl
@Override
public List<User> getUser() throws UserException {
System.out.println("被调用了1............");
return Arrays.asList(new User[]{new User(1,"yz","china","hlj")
,new User(2,"zwl","china","ah")
,new User(3,"hhj","china","zj")});
}
UserServiceImpl2
@Override
public List<User> getUser() throws UserException {
System.out.println("被调用了2............");
return Arrays.asList(new User[]{new User(1,"yz","china","hlj")
,new User(2,"zwl","china","ah")
,new User(3,"hhj","china","zj")});
}
接下来在provider.xml
配置文件中提供者接口实现指向不同的两个类,并指定不同的版本
<bean id="userService1" class="com.yz.dubbo.impl.UserServiceImpl"></bean>
<bean id="userService2" class="com.yz.dubbo.impl.UserServiceImpl2"></bean>
<dubbo:service interface="com.yz.dubbo.api.IUserService" ref="userService1" version="1.0.0"></dubbo:service>
<dubbo:service interface="com.yz.dubbo.api.IUserService" ref="userService2" version="2.0.0"></dubbo:service>
在customer.xml 中指定消费者的版本号为1.0.0
<dubbo:reference id="userService" interface="com.yz.dubbo.api.IUserService" check="false" version="1.0.0"></dubbo:reference>
在customer.xml 中指定消费者的版本号为2.0.0
<dubbo:reference id="userService" interface="com.yz.dubbo.api.IUserService" check="false" version="2.0.0"></dubbo:reference>
可以看到了通过指定版本号分别调用了不同的接口实现,这样在实际开发中就能够实现新旧功能的过度