上一篇我们完成了disconf服务端的环境搭建,这一篇我们来看看客户端springboot如何继承disconf,最终在docker下运行。
假定你已经在本机搭建好了disconf的web端环境,并已经能使用localhost访问到disconf的web界面。
下面看客户端如何使用disconf。
新建一个springboot项目,勾选web和aop。至于为什么要勾aop,后面用到disconf的回调时才用的上,先不用管它。
然后在pom里添加disconf的依赖。最终pom.xml如下
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.tianyalei</groupId>
<artifactId>test_disconf</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>
<name>test_disconf</name>
<description>Demo project for Spring Boot</description>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.7.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>com.baidu.disconf</groupId>
<artifactId>disconf-client</artifactId>
<version>2.6.36</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-aop</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
disconf的官方文档地址:http://disconf.readthedocs.io/zh_CN/latest/tutorial-client/index.html,可以参考着来,它这个是基于spring的配置,全是xml,比较麻烦,我们用的是springboot,那就配置起来简单多了。
我们新建一个配置类,DisConfig
package com.tianyalei.disconf.config;import com.baidu.disconf.client.DisconfMgrBean;import com.baidu.disconf.client.DisconfMgrBeanSecond;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;/** * @author wuweifeng wrote on 2017/10/16. */@Configurationpublic class DisConfig { @Bean(destroyMethod = "destroy") public DisconfMgrBean getDisconfMgrBean() { DisconfMgrBean disconfMgrBean = new DisconfMgrBean(); disconfMgrBean.setScanPackage("com.tianyalei.disconf"); return disconfMgrBean; } @Bean(destroyMethod = "destroy", initMethod = "init") public DisconfMgrBeanSecond getDisconfMgrBean2() { return new DisconfMgrBeanSecond(); }}注意设置一下scanpackage设置包名。其他的没什么,配置类就这一类,很简单。
然后在resources下创建一个disconf.properties
# 是否使用远程配置文件# true(默认)会从远程获取配置 false则直接获取本地配置enable.remote.conf=true## 配置服务器的 HOST,用逗号分隔 127.0.0.1:8000,127.0.0.1:8000#conf_server_host=localhost:80# 版本, 请采用 X_X_X_X 格式version=1_0_0_0# APP 请采用 产品线_服务名 格式app=test_disconf# 环境env=local# debugdebug=true# 忽略哪些分布式配置,用逗号分隔ignore=# 获取远程配置 重试次数,默认是3次conf_server_url_retry_times=1# 获取远程配置 重试时休眠时间,默认是5秒conf_server_url_retry_sleep_seconds=1这里需要注意的地方有server_host地址,像这里我是跑在本机,并且上一篇的docker-compose.xml中配置了nginx的端口80并且映射本机的80,所以这里就直接写localhost:80.代表disconf服务端的地址,如果是部署在docker的话,需要写映射的容器别名,如nginxhost:80。version、app、env都需要和在server端添加的保持一致。
然后我们创建一个类,来使用disconf的配置功能。
package com.tianyalei.disconf.service;import com.baidu.disconf.client.common.annotations.DisconfItem;import org.springframework.stereotype.Service;/** * @author wuweifeng wrote on 2017/10/16. */@Servicepublic class PriceService { private double money = 1000; private static final String KEY = "money"; /** * 单项配置项 */ @DisconfItem(key = KEY) public double getMoney() { return money; } public void setMoney(double money) { this.money = money; }}这里有一个DisconfItem注解,指明了一个key,那么该项就会是一个可以动态配置的项了,在服务端通过修改key为money的项,就可以动态修改该值。
我们再写一个controller来获取该price的值,看看效果。
/** * @author wuweifeng wrote on 2017/10/16. */@RestControllerpublic class IndexController { @Autowired private PriceService priceService; @RequestMapping("/index") public Object getPrice() { return priceService.getMoney(); }}启动项目
可以看到如下报错信息,就是说连不上zookeeper,找不到zkhost。
那么这是什么意思呢,Disconf是使用zookeeper进行的配置信息推送,server变更后由zookeeper推送到client,在上一篇我们完成了server的配置。如果还记得的话,在配置tomcat时,里面有个zoo.properties,里面就是配置zookeeper的地址。
报错信息里的zkhost unknown就是从这里来的,client从server获取zookeeper的地址,得到了这样的地址 zkhost:2181,然后客户端连不上zookeeper,所以就报错了。
由于我们在部署zookeeper的docker时并没有开放它的对外端口,也就是无法从外面直接访问zookeeper,只能通过docker的link方式才行。所以要想跑起来这个client demo,也得在docker环境下。
我们在工程根目录创建dockerfile
FROM hub.c.163.com/wuxukun/maven-aliyun:3-jdk-8ADD pom.xml /tmp/build/ADD src /tmp/build/src #构建应用RUN cd /tmp/build && mvn clean package \ #拷贝编译结果到指定目录 && mv target/*.jar /app.jar \ #清理编译痕迹 && cd / && rm -rf /tmp/buildVOLUME /tmpEXPOSE 8080ENTRYPOINT ["java","-jar","/app.jar"]然后注意修改disconf.properties里的host地址为
conf_server_host=nginxhost:80在docker下localhost是不行的,也要通过link的方式去获取nginx容器的ip地址。
构建镜像,在工程根目录下执行
docker build -t test_disconf .等到构建完毕,可以得到一个叫test_disconf的镜像。
先看看上一篇已经启动好的容器:docker ps
启动该镜像,需要注意,我们此前已经启动过了一个docker-compose.xml了,而现在我们要启动一个新的容器,并且要link之前的里面的容器。我们先来看看普通的启动用法:
docker run --link=wuwf_disconf_zookeeper_1:zkhost --link=wuwf_disconf_nginx_1:nginxhost -d -p 8080:8080 test_disconf
发现报错了,说not belong to the default network,这里有解决方案,https://*.com/questions/36489696/cannot-link-to-a-running-container-started-by-docker-compose
就是说docker-compose启动的docker在一个network里,你现在又启动了一个,在另一个network里,不同的network之间不能link。
我们通过命令来看一下docker network ls
可以看到之前的network为wuwf_default,下面我们就可以通过如下的方式来link了
docker run --link=wuwf_disconf_zookeeper_1:zkhost --link=wuwf_disconf_nginx_1:nginxhost --net wuwf_default -d -p 8080:8080 test_disconf添加--net就OK了。
再次执行,启动成功了。
启动成功后我们就可以在后台web界面看到
我们测试一下:
访问
localhost:8080/index
可以看到这里取到的price的值就已经是从Disconf后台配置的了,不再是代码里写的100.
我们来修改一下price的值
可以看到后台修改后,立马就生效了。
这就是配置中心的使用,后面来介绍一下复杂的配置,不仅仅是这种单个属性的单项配置。