Docker下使用disconf：細說demo開發

Docker下的disconf實戰全文連接

1. 《Docker搭建disconf環境，三部曲之一：極速搭建disconf》；
2. 《Docker搭建disconf環境，三部曲之二：本地快速構建disconf鏡像》；
3. 《Docker搭建disconf環境，三部曲之三：細說搭建過程》；
4. 《Docker下使用disconf：極速體驗》；
5. 《Docker下使用disconf：細說demo開發》；

細說demo開發

在上一章《docker下使用disconf：極速體驗》中咱們體驗了disconf服務的使用方獲取配置以及實時感知到這個配置變化的效果，今天咱們一塊兒來實踐這個demo的開發過程，學會在項目中使用disconf服務。

此demo源於disconf官網的demo(git地址:git@github.com:knightliao/disconf-demos-java.git，下有三個工程，此文的demo源自其中的disconf-standalone-demo)，官方demo展現了大而全的功能，作爲初學者的我花了很多時間去看，所以我就基於官方代碼作了精簡，精簡後的代碼旨在快速爲初學者展現最基本的遠程配置和實時感知配置變化的能力，若要系統的學習disconf的各種服務，還請自行研究官方文檔和demo。

本文demo的源碼在git@github.com:zq2599/blog_demos.git，下載後的裏面有多個工程，下圖紅框中的工程纔是本文的demo：

接下來咱們看看調用disconf服務須要哪些步驟：

1. 因爲這是個maven工程，因此首先要肯定依賴包，咱們用到的主要有disconf的庫，以及spring和日誌等經常使用庫，以下：

<dependencies>

        <dependency>
            <groupId>com.baidu.disconf</groupId>
            <artifactId>disconf-client</artifactId>
            <version>2.6.36</version>
        </dependency>

        <dependency>
            <groupId>commons-io</groupId>
            <artifactId>commons-io</artifactId>
            <version>1.4</version>
        </dependency>

        <dependency>
            <groupId>commons-lang</groupId>
            <artifactId>commons-lang</artifactId>
            <version>2.4</version>
        </dependency>

        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.6</version>
        </dependency>

        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-core</artifactId>
            <version>1.0.9</version>
        </dependency>

        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.0.9</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>4.1.7.RELEASE</version>
        </dependency>
    </dependencies>

maven的構建插件是做者自定義的，除了基本功能，還生成了一些腳本工具，咱們直接使用：

<plugin>
                <groupId>com.github.knightliao.plugin</groupId>
                <artifactId>starter-shade-maven-plugin</artifactId>
                <version>1.0.0</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <finalName>${project.build.finalName}</finalName>
                            <transformers>
                                <transformer
                                        implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                    <mainClass>com.example.disconf.demo.DisconfDemoMain</mainClass>
                                </transformer>
                                <transformer
                                        implementation="org.apache.maven.plugins.shade.resource.DontIncludeResourceTransformer">
                                    <resources>
                                        <resource>env</resource>
                                        <resource>disconf.properties</resource>
                                        <resource>logback.xml</resource>
                                    </resources>
                                </transformer>
                                <transformer
                                        implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
                                    <resource>META-INF/spring.handlers</resource>
                                </transformer>
                                <transformer
                                        implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
                                    <resource>META-INF/spring.schemas</resource>
                                </transformer>
                            </transformers>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

2. 程序入口是DisconfDemoMain類，裏面的main方法初始化spring環境，啓動一個while死循環，每隔五秒將JedisConfig實例的host和port屬性打印到終端；

3. JedisConfig的host和port屬性，是被disconf的runtime環境控制，能夠實時被設置成最新的配置值，對應的遠程配置和具體的屬性字段，都是經過註解來完成的：

如上圖所示：

紅框中的DisconfFile註解將該類和disconf服務端的redis.properties配置綁定; 黃框中的DisconfFileItem註解將host和port屬性與redis.properties配置的host，port屬性綁定; 紫框中的DisconfUpdateService註解向disconf運行時註冊了配置變化的實時廣播監聽，當配置發生變化時，藍框中的reload方法會被disconf運行時調用；

4. SimpleRedisServiceUpdateCallback類的做用也是註冊廣播監聽，當配置發生變化時，藍框中的reload方法會被disconf運行時調用；

5. 除了代碼，還要關注disconf.properties文件:

# 是否使用遠程配置文件
# true(默認)會從遠程獲取配置 false則直接獲取本地配置
disconf.enable.remote.conf=true

#
# 配置服務器的 HOST,用逗號分隔  127.0.0.1:8004,127.0.0.1:8004
#
disconf.conf_server_host=nginxhost:80
#disconf.conf_server_host=127.0.0.1:80

# 版本, 請採用 X_X_X_X 格式 
disconf.version=1_0_0_0

# APP 請採用 產品線_服務名 格式 
disconf.app=disconf_demo

# 環境disco
disconf.env=rd

# 忽略哪些分佈式配置，用逗號分隔
disconf.ignore=

# 獲取遠程配置 重試次數，默認是3次
disconf.conf_server_url_retry_times=1
# 獲取遠程配置 重試時休眠時間，默認是5秒
disconf.conf_server_url_retry_sleep_seconds=1

# 用戶指定的下載文件夾, 遠程文件下載後會放在這裏
disconf.user_define_download_dir=./disconf/download2

# 下載的文件會被遷移到classpath根路徑下，強烈建議將此選項置爲 true(默認是true)
disconf.enable_local_download_dir_in_class_path=true

conf_server_host的值在此處配置成nginxhost,這個和docker容器啓動時配置的nginx的link別名一致，這樣demo就能訪問到disconf服務器了；

6. disconf在demo上的運行時環境，是經過spring配置來實現的，以下：

<context:component-scan base-package="com.example"/>

    <aop:aspectj-autoproxy proxy-target-class="true"/>

    <!-- 使用disconf必須添加如下配置 -->
    <bean id="disconfMgrBean" class="com.baidu.disconf.client.DisconfMgrBean"
          destroy-method="destroy">
        <property name="scanPackage" value="com.example.disconf.demo"/>
    </bean>
    <bean id="disconfMgrBean2" class="com.baidu.disconf.client.DisconfMgrBeanSecond"
          init-method="init" destroy-method="destroy">
    </bean>

disconfMgrBean複製核心管理，disconfMgrBean2負責啓動定時掃描和實現銷燬時的回調。

7. 配置好這些，打開控制檯，在pom.xml文件所在目錄下執行<font color="blue">mvn clean package -U</font>，便可完成打包，這時候進入target目錄，能夠看到執行結果以下圖：

8. 打開上圖中的starter-run文件夾中的start.sh文件，最下面一行內容以下：

nohup java $JAVA_OPTS -jar ${CUR_BUNDLE_NAME} >> log_`date +%s`.log 2>&1 &

這個命令會啓動java進程，而且把輸出信息重定向到日誌文件中，這樣就不便於咱們觀察demo的運行效果，動手把這一行修改以下：

java $JAVA_OPTS -jar ${CUR_BUNDLE_NAME}

這樣全部的日誌都會在控制檯打印出來，便於咱們觀察運行狀態；

9. 打包完成了，如今能夠開始製做鏡像了，這裏的基礎鏡像我選用的是<font color="blue">tomcat:7.0.77-jre8</font>，是爲了圖個方便，不用安裝jdk和配置java環境了，dockerfile內容很是簡單，建立一個工做目錄，把前面打包時生成的starter-run文件夾下的全部東西都複製到這個工做目錄中去：

# Docker image of disconf consumer
# VERSION 0.0.1
# Author: bolingcavalry

#基礎鏡像使用tomcat:7.0.77-jre8
FROM tomcat:7.0.77-jre8

#做者
MAINTAINER BolingCavalry <zq2599@gmail.com>

#定義工做目錄
ENV WORK_PATH /usr/local/work

#建立工做文件夾
RUN mkdir -p $WORK_PATH

#複製應用包到工做文件夾
COPY ./starter-run $WORK_PATH/

打開終端，在dockerfile的目錄下執行如下命令生成鏡像:

docker build -t local_disconf_standalone_demo:0.0.1 .

10. 新建一個docker-compose.yml文件，內容以下所示：<font color="red">(這裏要重點注意的是disconf_java的link配置，除了鏈接disconf_nginx，還要鏈接disconf_zookeeper，不然啓動demo的時候會提示watcher啓動失敗，致使在disconf服務端修改配置後，demo收不到配置更新的廣播)</font>：

version: '2'
services:
  disconf_redis_1: 
    image: daocloud.io/library/redis
    restart: always
  disconf_redis_2: 
    image: daocloud.io/library/redis
    restart: always
  disconf_zookeeper: 
    image: zookeeper:3.3.6
    restart: always
  disconf_mysql: 
    image: bolingcavalry/disconf_mysql:0.0.1
    environment:
      MYSQL_ROOT_PASSWORD: 123456
    restart: always
  disconf_tomcat: 
    image: bolingcavalry/disconf_tomcat:0.0.1
    links: 
      - disconf_redis_1:redishost001 
      - disconf_redis_2:redishost002
      - disconf_zookeeper:zkhost
      - disconf_mysql:mysqlhost
    restart: always
  disconf_nginx: 
    image: bolingcavalry/disconf_nginx:0.0.1
    links: 
      - disconf_tomcat:tomcathost 
    ports: 
      - "80:80" 
    restart: always
  disconf_java: 
    image: local_disconf_standalone_demo:0.0.1
    links: 
      - disconf_nginx:nginxhost
      - disconf_zookeeper:zkhost
    restart: always

11. 在docker-compose.yml文件所在目錄下執行命令<font color="blue">docker-compose up -d</font>，啓動全部容器，以下圖：

12. 執行命令<font color="blue">08_disconf_java_1</font>進入容器，再進入/usr/local/work目錄，執行./start.sh啓動demo，便可看到disconf本地運行時的啓動信息，以及每隔5秒一次的輸出配置信息；

13. 在瀏覽器上輸入localhost，登陸disconf，用戶名密碼都是admin，修改對應的配置項，在docker容器08_disconf_java_1的控制檯便可看到對應的輸出，具體操做方法請參照上一章《docker下使用disconf：極速體驗》

14. 本章用到的docker鏡像的製做材料也已經上傳到git上，地址：git@github.com:zq2599/docker_disconf.git，目錄以下圖紅框：

至此，一個使用disconf的demo已經完成了開發和使用，這只是給你們帶來初步的認識，deisonf的配置服務是很豐富的，你們能夠在官網的文檔和demo中獲取更詳細的信息。

歡迎關注個人公衆號