玩转Spring Cloud之配置中心（config server &config client）

最新推荐文章于 2023-07-14 12:03:40 发布
最新推荐文章于 2023-07-14 12:03:40 发布
阅读量239 收藏
点赞数
分类专栏： 微服务 文章标签： spring cloud config
原文链接：https://www.cnblogs.com/zuowj/p/10432445.html
版权

玩转Spring Cloud之配置中心（config server &config client）

 本文内容导航：

一、搭建配置服务中心（config server）

　　1.1.git方式

　　1.2.svn方式

　　1.3.本地文件方式

　　1.4.解决配置中包含中文内容返回乱码问题

二、搭建配置消费客户端（config client）

　　2.1.通过@value方式获取配置信息

　　2.2.通过创建一个映射远程配置信息的Bean（RemoteConfigProperties） 方式获取配置信息

　　2.3.通过Environment来直接获取配置信息

　　2.4.实现配置信息自动刷新

　　2.5.加入到注册中心配置成高可用集群环境

 

上篇总结了熔断降级（Hystrix）与监控的使用方式，里面涉及到的一些重点的知识细节我都有说明，网上很多的spring cloud教程只是简单的贴代码、简单描述，而我的文章是要体现知识的积累与开发时的参考，故花了一些时间描述了一些细节，这些细节能帮助我自己（梦在旅途）以及大家少走弯路，本文仍然围绕这个中心思想来总结描述关于配置中心的搭建与使用，实现了多种搭建配置服务中心（config server），也实现了多种配置消费客户端的实现方式。（多种配置消费方式目前很少有人总结，而我在本文中有特别介绍，不一定都用得上，但应该要了解，以便举一反三灵活运用）,好了废话不多说，直接开始本文主题。

首先我们要了解，为什么需要配置中心？配置中心能解决什么问题？回答这些问题可以参见：https://www.cnblogs.com/xiaoqi/p/configserver-compair.html，我这里简要说明一下：JAVA应用一般常用的配置文件是：xxx.Properties 或 xxx.yml文件，.NET（.NET CORE）一般常用的配置文件是：xxx.config 或 xxx.json 甚至是xxx.ini,它们都能够很好的应对单机本地配置的需求（可以多个应用共用同一个目录位置的配置文件），但如果是分布式应用，那么本地配置文件在某些场景下就显得不那么合适了，因为一是存在配置冗余（不同机器上配置相同的配置信息），二是无法快速同步配置信息（如果要更改配置信息，就得每台服务器一台一台的更改，或使用文件同步机制稍微能保证尽快同步），三是没有多版本管理，出现更新配置后有问题无法快速回滚（如有问题，需重新配置或人为将之前的备份的配置文件一台台服务器更新或文件同步到多台服务器），比如：数据库连接字符串，如果使用本地配置就存在如上说的三点问题，正因为存在这些问题，所以才有了分布式配置中心框架来解决这些问题。

 分布式配置中心的主流框架有很多，由于本文是总结spring cloud系列的文章，故这里通过DEMO来实现分布式配置中心Server端及Client消费端（读取配置），并确保高可用。

一、搭建配置服务中心（config server）

　　首先通过IDEA spring initializer（或直接通过https://start.spring.io/）创建一个spring boot项目(demo项目命名：configserver)，创建过程中选择：config server依赖，生成项目后的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>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.3.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <groupId>cn.zuowenjun.cloud</groupId>
    <artifactId>configserver</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>configserver</name>
    <url>http://www.zuowenjun.cn</url>
    <description>Demo project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
        <spring-cloud.version>Greenwich.RELEASE</spring-cloud.version>
    </properties>

    <dependencies>
        <!--spring cloud配置中心依赖[默认GIT]-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-config-server</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <jvmArguments>-Dfile.encoding=UTF-8</jvmArguments>
                </configuration>
            </plugin>
        </plugins>
    </build>

    <repositories>
        <repository>
            <id>spring-milestones</id>
            <name>Spring Milestones</name>
            <url>https://repo.spring.io/milestone</url>
        </repository>
    </repositories>

</project>

　　然后下面分别介绍通过三种方式来实现配置中心：（注意三种方式均使用上面的项目初始环境，下面不再介绍）

　　1.1.git方式（即：将GIT仓库【GITHUB、GITLAB、 GITEE等】作为配置集中存储的介质）

　　　　前提工作：既然是使用GIT仓库作为配置存储，那我们首先就得在相关的GIT站点上创建用于存放config信息的仓库，如我（梦在旅途）在自己的github上创建了一个learning-demos/config仓库目录，然后在config目录下分别创建两个环境的配置文件（http://configclient-dev.properties、http://configclient-prod.properties），配置文件命名规则应尽可能使用：{application}-{profile}.{properties|yml}，如下是GIT中两个文件配置的演示内容：（演示仓库地址：https://github.com/zuowj/learning-demos）

  configclient-dev.properties 文件内容（测试环境）：

demo-config-profile-env=dev
zuowenjun.site=http://www.zuowenjun.cn,http://zuowj.cnblogs.com--20190226.AAAXX66
zuowenjun.skills=.net,java,html,js,css,sql,python,vb--20190226.BBBXX66
zuowenjun.motto=Learning is endless; Opportunity is for the prepared mind;--20190226.CCCXX1

 configclient-prod.properties 文件内容（生产环境）： 


demo-config-profile-env=prod
zuowenjun.site=http://www.zuowenjun.cn,http://zuowj.cnblogs.com,http://github.com/zuowj
zuowenjun.skills=.net,java,html,js,css,sql,python,vb
zuowenjun.motto=Learning is endless; Opportunity is for the prepared mind;学无止境；机会是留给有准备的人

 

　　1.1.1.在spring boot启动类（ConfigserverApplication）上添加@EnableConfigServer注解，代码如下：

 

package cn.zuowenjun.cloud;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.config.server.EnableConfigServer;

@EnableConfigServer
@SpringBootApplication
public class ConfigserverApplication {

    public static void main(String[] args) {
        SpringApplication.run(ConfigserverApplication.class, args);
    }

}

　　1.1.2.在配置文件（application.yml，当然也可以是application.properties看个人喜好，本系列均采用yml）中进行如下配置，重点关注spring.cloud.config节点，相关配置参数有注释说明：

spring:
  application:
    name: configserver
  profiles:
    active: git #设置使用本地配置(默认是git,可以设置：subversion(SVN)，native(本地))
  cloud:
    config:
      server:
        #如下是GIT配置
        git:
          uri: https://github.com/zuowj/learning-demos     # 配置git仓库的地址（最后不需要带/，否则会出现：No custom http config found for URL: XXX）
          search-paths: config                             # git仓库地址下的相对搜索地址（可用使用通配符），可以配置多个，用,分割。可以{application}实现按应用查配置
          username:                                             # git仓库的账号（公开仓库无需账号信息）
          password:                                             # git仓库的密码（公开仓库无需账号信息）
          default-label: master                             #git默认分支

　　通过上述简单的两步即完成搭建基于GIT的配置服务中心，启动运行项目，GIT仓库中的配置文件会被自动转换成当前项目的web api，若需访问查看远程配置数据可以参照以下的规则：

/{application}/{profile}[/{label}]
[/{label}]/{application}-{profile}{.yml|.properties|.json}

　　规则简单说明：{application}=配置消费方应用名称（即：config client的项目名，通俗讲：就是谁用这个配置就是谁的名字）,{profile}=配置环境（如：dev开发环境,test测试环境,prod生产环境）,{label}=仓库分支名（git或svn方式指定，native本地方式无需指定），.yml|.properties|.json表示指定的响应返回格式，{}表示必需,[]表示可选，|表示或的关系，例如本Demo项目访问：

http://localhost:8866/configclient/dev 、http://localhost:8866/configclient/dev/master
http://localhost:8866/configclient-dev.yml、http://localhost:8866/configclient-dev.properties
http://localhost:8866/configclient-dev.json、http://localhost:8866/master/configclient-dev.yml

　　最终可以根据访问URL规则返回相应的内容，类似如下：

 

//request: http://localhost:8866/configclient-dev.yml

demo-config-profile-env: dev
zuowenjun:
  motto: Learning is endless; Opportunity is for the prepared mind;--20190226.CCCXX1
  site: http://www.zuowenjun.cn,http://zuowj.cnblogs.com--20190226.AAAXX66
  skills: .net,java,html,js,css,sql,python,vb--20190226.BBBXX66

//request: http://localhost:8866/configclient-dev.properties

demo-config-profile-env: dev
zuowenjun.motto: Learning is endless; Opportunity is for the prepared mind;--20190226.CCCXX1
zuowenjun.site: http://www.zuowenjun.cn,http://zuowj.cnblogs.com--20190226.AAAXX66
zuowenjun.skills: .net,java,html,js,css,sql,python,vb--20190226.BBBXX66

//request: http://localhost:8866/configclient-dev.json
{"demo-config-profile-env":"dev","zuowenjun":{"motto":"Learning is endless; Opportunity is for the prepared mind;--20190226.CCCXX1","site":"http://www.zuowenjun.cn,http://zuowj.cnblogs.com--20190226.AAAXX66","skills":".net,java,html,js,css,sql,python,vb--20190226.BBBXX66"}}

//request: http://localhost:8866/configclient/dev

{"name":"configclient","profiles":["dev"],"label":null,"version":"d4616a65c8429b9dd3a67ff226b125ae6a0959bb","state":null,"propertySources":[{"name":"https://github.com/zuowj/learning-demos/config/configclient-dev.properties","source":{"zuowenjun.skills":".net,java,html,js,css,sql,python,vb--20190226.BBBXX66","zuowenjun.site":"http://www.zuowenjun.cn,http://zuowj.cnblogs.com--20190226.AAAXX66","demo-config-profile-env":"dev","zuowenjun.motto":"Learning is endless; Opportunity is for the prepared mind;--20190226.CCCXX1"}}]}

 　　可以看到GIT中的配置信息通过config server的API能够正常返回，表示搭建成功，另外需要注意的是如果配置文件中包含中文，那么可能中文返回的就是乱码了，上面如果浏览prod生产环境【生产环境我特意配置了中文】，如：http://localhost:8866/configclient/prod，那么中文就会乱码，解决方案后面会说明，此处了解有这个情况即可。

　　1.2.svn方式（即：将SVN仓库作为配置集中存储的介质）

　　　　前提工作：如同GIT方式一样，要使用SVN仓库作为配置存储，那就需要SVN服务器，将创建用于存放config信息的仓库，如我（梦在旅途）在SVN服务器创建了app-config仓库目录，然后在trunk主干中仍然添加两个配置文件(dev,prod)与GIT方式文件名相同，内容如下（内容与GIT方式也基本相同，只是稍微改变内容以便区分）：(演示仓库地址：http://svnhost:port/svn/app-config/trunk)

 configclient-dev.properties 文件内容：

demo-config-profile-env=dev-svn
zuowenjun.site=http://www.zuowenjun.cn,http://zuowj.cnblogs.com--20190227
zuowenjun.skills=.net,java,html,js,css,sql,python,vb--20190227
zuowenjun.motto=Learning is endless; Opportunity is for the prepared mind;--20190227

configclient-prod.properties 文件内容：

demo-config-profile-env=prod-svn
zuowenjun.site=http://www.zuowenjun.cn,http://zuowj.cnblogs.com,http://github.com/zuowj
zuowenjun.skills=.net,java,html,js,css,sql,python,vb
zuowenjun.motto=Learning is endless; Opportunity is for the prepared mind;学无止境；机会是留给有准备的人

 

　　1.2.1.由于GIT是默认的实现方式，当引入spring-cloud-config-server时，它就具备了相关的框架处理能力，而这里使用SVN，就需要在POM XML中除了添加config-server依赖外还需单独添加SVN实现方式的依赖，配置如下：

 

        <!--spring cloud配置中心依赖[默认GIT]-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-config-server</artifactId>
        </dependency>
        <!--使用SVN作为配置中心依赖-->
        <dependency>
            <groupId>org.tmatesoft.svnkit</groupId>
            <artifactId>svnkit</artifactId>
        </dependency>

 

 　　1.2.2.在配置文件（application.yml)中进行如下配置，仍然重点关注spring.cloud.config节点，相关配置参数有注释说明：

 

server:
  port: 8866

spring:
  application:
    name: configserver
  profiles:
    active: subversion #设置使用本地配置(默认是git,可以设置：subversion(SVN)，native(本地))
  cloud:
    config:
      server:
        #如下是SVN配置
        svn:
          uri: http://svnhost:port/svn/app-config #SVN仓库地址
          username: svnuser #SVN账号(如果没有权限可为空)
          password: svnpassword #SVN密码(如果没有权限可为空)
          default-label: trunk #默认SVN分支

 

　　通过上述简单的两步即完成搭建基于SVN的配置服务中心，启动运行项目，SVN仓库中的配置文件会被自动转换成当前项目的web api，访问路径与GIT方式完全相同在此不重述。（参照1.1.2访问URL，可以得到SVN仓库trunk分支里配置文件配置信息的内容）

　　1.3.本地文件方式（即：将config server项目所有服务器的本地文件存放目录作为配置集中存储的介质）

　　1.3.1.先在config server项目文件服务器创建指定存放配置的目录，如本demo是直接创建在项目的resources/configs目录，仍然是创建与GIT相同的两个配置文件（dev、prod），配置内容如下：

 configclient-dev.properties 文件内容：

demo-config-profile-env=dev-native
zuowenjun.site=http://www.zuowenjun.cn,http://zuowj.cnblogs.com--20190227
zuowenjun.skills=.net,java,html,js,css,sql,python,vb--20190227
zuowenjun.motto=Learning is endless; Opportunity is for the prepared mind;--20190227

 configclient-prod.properties 文件内容：


demo-config-profile-env=prod-native
zuowenjun.site=http://www.zuowenjun.cn,http://zuowj.cnblogs.com,http://github.com/zuowj
zuowenjun.skills=.net,java,html,js,css,sql,python,vb
zuowenjun.motto=Learning is endless; Opportunity is for the prepared mind;学无止境；机会是留给有准备的人

 

　　1.3.2.在配置文件（application.yml)中进行如下配置，仍然重点关注spring.cloud.config节点，相关配置参数有注释说明：（很简单，只需要设置profiles.active=native，然后在native节点设置查找配置的存放目录即可）

 

server:
  port: 8866

spring:
  application:
    name: configserver
  profiles:
    active: native #设置使用本地配置(默认是git,可以设置：subversion(SVN)，native(本地))
  cloud:
    config:
      server:
        #如下是本地文件配置
        native:
          search-locations: classpath:/configs #配置文件存放的目录

 

　　通过上述简单的两步即完成搭建基于本地文件的配置服务中心，启动运行项目，存放的配置文件会被自动转换成当前项目的web api，访问路径与GIT方式完全相同在此不重述。（参照1.1.2访问URL，可以得到本地文件配置信息的内容）

　　1.4.解决配置中包含中文内容返回乱码问题（此处实现方式参照网上说明，在此只是集中说明，便于大家理解）--均适用于以上三种方式

 　　乱码原因及解决方案思路可参见：https://blog.csdn.net/sinat_38843093/article/details/79960777?utm_source=blogxgwz4，但由于最新版本的spring boot的PropertySourceLoader接口定义有些不同故我这里参照该文进行完善并最终解决乱码。

　　首先自定义一个实现了PropertySourceLoader的类：MyPropertySourceLoader，并实现接口的方法逻辑，具体代码如下：（最重要的代码是：properties.load(new InputStreamReader(inputStream, StandardCharsets.UTF_8));即表示使用UTF8的字符集来读取配置文件流信息）

 View Code

　　然后在resources目录下创建META-INF目录，然后在该目录中创建spring.factories文件（这里spring boot的扩展配置文件），在该文件中输入如下内容即可：

org.springframework.boot.env.PropertySourceLoader=cn.zuowenjun.cloud.MyPropertySourceLoader

若想了解spring.factories相关信息，可参考：https://blog.csdn.net/lvoyee/article/details/82017057、 https://blog.csdn.net/boling_cavalry/article/details/83048588

　通过上述步骤，现在无论是哪种方式访问配置中心的API，若涉及中文都能正常返回不会乱码，如下图所示：(当然如果使用[/{label}]/{application}-{profile}{.yml|.properties|.json}这种方式访问可能还会出现乱码，具体原因我还未了解，求大神们指点，但目前已不影响配置消费【即：配置消费方获取到的中文信息均是正常不会乱码】)

　　

二、搭建配置消费客户端（config client）

　　首先通过IDEA spring initializer（或直接通过https://start.spring.io/）搭建spring boot + spring MVC(Rest API)空项目，创建过程中选择：web、config client依赖，最后生成的POM XML文件如下：（如果缺少依赖请自行手动添加）

 View Code

　　然后在resources目录下创建bootstrap.yml文件，并在配置文件中添加如下内容：（如果想了解bootstrap与application配置文件两者的区别，请参见：https://www.cnblogs.com/BlogNetSpace/p/8469033.html）

 

server:
  port: 8008

spring:
  application:
    name: configclient

  cloud:
    config:
      name: configclient #对应config server Url中的{application}
      profile: prod #配置环境，对应config server Url中的{profile}
      #label: trunk #配置分支(不配置则默认：git则是master,svn则是trunk)，
      uri: http://localhost:8866 #配置中心地址

 

　　最后下面分别介绍实现各种不同的配置消费（读取配置）方式：（注意均使用上面的项目初始环境，同时以下的几种服务配置消费方式均可同时并存在一个项目中）

　　2.1.通过@value方式获取配置信息

　　　　这种最为简单，网上也大部份是这种，我这里为了便于区分配置属性与controller本身使用了继承的方式（注意，我这里用继承而没有使用单独定义一个RemoteConfig配置类+Value，是因为经我验证发现将会影响配置自动刷新，具体原因还未查清，初步判断与加上@RefreshScope注解上生成的代理类有关系），代码结构更清晰，实现代码如下：

 

package cn.zuowenjun.cloud.model;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;


public abstract class RemoteConfig {

    @Value("${demo-config-profile-env}")
    public String profileEnv;

    @Value("${zuowenjun.site}")
    public String zwjSite;

    @Value("${zuowenjun.skills}")
    public String zwjSkills;

    @Value("${zuowenjun.motto}")
    public String zwjMotto;
}



package cn.zuowenjun.cloud.Controller;

import cn.zuowenjun.cloud.model.RemoteConfig;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.HashMap;
import java.util.Map;

@RestController
@RequestMapping("/demo")
public class DemoController extends RemoteConfig {


    @RequestMapping("/config/byval")
    public Object getRemoteConfigByValue(){
        Map<String,Object> model=new HashMap<>();
        model.put("getMode","@Value");

        Map<String,String> remoteCgfMap=new HashMap<>();
        remoteCgfMap.put("profileEnv", this.profileEnv);
        remoteCgfMap.put("zwjSite", this.zwjSite);
        remoteCgfMap.put("zwjSkills",this.zwjSkills);
        remoteCgfMap.put("zwjMotto", this.zwjMotto);

        model.put("remoteConfig",remoteCgfMap);


        return model;
    }



}

 

　　如上代码所示，我们只需在类成员字段上标记@Value注解，并指定要获取的配置中心上配置项的名称即可。运行项目，访问：http://localhost:8008/demo/config/byval,即可响应返回获取到的config信息，如下图示：

　　2.2.通过创建一个映射远程配置信息的Bean（RemoteConfigProperties） 方式获取配置信息

　　首先定义一个映射远程配置信息的Bean类：RemoteConfigProperties，该类中所有的属性名均需与配置中心上配置文件的配置内容相同（名字以及层级都需相同，若配置项名称有-，则配置类中请忽略直接拼接命名即可但需符合lowerCamelCase，如：demo-config-profile-env，则字段名为：demoConfigProfileEnv，如果属性中有点( . )，则应视为点后面的部分为下级，应再定义相关的配置映射类），该类完整代码如下：

 

package cn.zuowenjun.cloud.model;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties()//如果有前缀，则可以设置prefix=XXX
public class RemoteConfigProperties {

    private String demoConfigProfileEnv;
    private Zuowenjun zuowenjun;

    public String getDemoConfigProfileEnv() {
        return demoConfigProfileEnv;
    }

    public void setDemoConfigProfileEnv(String demoConfigProfileEnv) {
        this.demoConfigProfileEnv = demoConfigProfileEnv;
    }

    public Zuowenjun getZuowenjun() {
        return zuowenjun;
    }

    public void setZuowenjun(Zuowenjun zuowenjun) {
        this.zuowenjun = zuowenjun;
    }

    public static class Zuowenjun {

        private String site;
        private String skills;
        private String motto;


        public String getSite() {
            return site;
        }

        public void setSite(String site) {
            this.site = site;
        }

        public String getSkills() {
            return skills;
        }

        public void setSkills(String skills) {
            this.skills = skills;
        }

        public String getMotto() {
            return motto;
        }

        public void setMotto(String motto) {
            this.motto = motto;
        }

    }

}

 

如上代码所示，属性字段名与配置项的命名保持一致，若有下级则定义下级的配置类，这里下级配置类（Zuowenjun）采用了内部静态类的方式（注意这里如果是内部类，一定是static，而不能是普通的class，因为内部普通类与内部静态类是有区别的，具体可参见：java 内部类和静态内部类的区别），也可以单独定义一个类，同时在配置类上标记了@ConfigurationProperties（这指明了该类是配置映射类）,@Component这个不用说了吧就是表示能自动被spring IOC容器扫描并注册。

　　然后在DemoController中增加字段注入该类：RemoteConfigProperties，并添加用于读取RemoteConfigProperties类中的配置信息的方法（getRemoteConfigByPropertiesBean），具体代码如下：(这里保留了@Value方式的代码)

 

package cn.zuowenjun.cloud.Controller;

import cn.zuowenjun.cloud.model.RemoteConfig;
import cn.zuowenjun.cloud.model.RemoteConfigProperties;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.core.env.Environment;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.HashMap;
import java.util.Map;

@RestController
@RequestMapping("/demo")
public class DemoController extends RemoteConfig {


    @Autowired
    private RemoteConfigProperties remoteConfigProperties;

    @RequestMapping("/config/byval")
    public Object getRemoteConfigByValue(){
        Map<String,Object> model=new HashMap<>();
        model.put("getMode","@Value");

        Map<String,String> remoteCgfMap=new HashMap<>();
        remoteCgfMap.put("profileEnv", this.profileEnv);
        remoteCgfMap.put("zwjSite", this.zwjSite);
        remoteCgfMap.put("zwjSkills",this.zwjSkills);
        remoteCgfMap.put("zwjMotto", this.zwjMotto);

        model.put("remoteConfig",remoteCgfMap);


        return model;
    }

    @RequestMapping("/config/byprops")
    public Object getRemoteConfigByPropertiesBean(){
        Map<String,Object> model=new HashMap<>();
        model.put("getMode","Properties Bean");
        model.put("remoteConfig",remoteConfigProperties);
        return model;
    }



}

　　最后启动运行项目，访问：http://localhost:8008/demo/config/byprops,即可响应返回获取到的config信息，如下图示：

　　2.3.通过Environment来直接获取配置信息

　　　　其实上面2种方式底层都是使用这种方式来获取配置信息的只是包装了后大家无需关心而矣，核心是通过environment.getProperty方法来获取对应的配置信息的，这种方式只需在DemoController增加字段注入Environment的实例，然后添加一个从Environment获取配置信息的方法即可（getRemoteConfigByEnv），具体代码如下：（保留@Value方式、映射远程配置信息的Bean（RemoteConfigProperties） 方式）

 

package cn.zuowenjun.cloud.Controller;

import cn.zuowenjun.cloud.model.RemoteConfig;
import cn.zuowenjun.cloud.model.RemoteConfigProperties;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.core.env.Environment;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.HashMap;
import java.util.Map;


@RestController
@RequestMapping("/demo")
public class DemoController extends RemoteConfig {


    @Autowired
    private Environment environment;

    @Autowired
    private RemoteConfigProperties remoteConfigProperties;

    @RequestMapping("/config/byval")
    public Object getRemoteConfigByValue(){
        Map<String,Object> model=new HashMap<>();
        model.put("getMode","@Value");

        Map<String,String> remoteCgfMap=new HashMap<>();
        remoteCgfMap.put("profileEnv", this.profileEnv);
        remoteCgfMap.put("zwjSite", this.zwjSite);
        remoteCgfMap.put("zwjSkills",this.zwjSkills);
        remoteCgfMap.put("zwjMotto", this.zwjMotto);

        model.put("remoteConfig",remoteCgfMap);


        return model;
    }

    @RequestMapping("/config/byprops")
    public Object getRemoteConfigByPropertiesBean(){
        Map<String,Object> model=new HashMap<>();
        model.put("getMode","Properties Bean");
        model.put("remoteConfig",remoteConfigProperties);
        return model;
    }

    @RequestMapping("/config/byenv")
    public  Object getRemoteConfigByEnv(){
        Map<String,Object> model=new HashMap<>();
        model.put("getMode","Environment");

        Map<String,String> remoteCgfMap=new HashMap<>();
        remoteCgfMap.put("profileEnv", environment.getProperty("demo-config-profile-env"));
        remoteCgfMap.put("zwjSite", environment.getProperty("zuowenjun.site"));
        remoteCgfMap.put("zwjSkills", environment.getProperty("zuowenjun.skills"));
        remoteCgfMap.put("zwjMotto", environment.getProperty("zuowenjun.motto"));

        model.put("remoteConfig",remoteCgfMap);
        return  model;
    }


}

最后启动运行项目，访问：http://localhost:8008/demo/config/byenv,即可响应返回获取到的config信息，如下图示：

如上三种方式配置文件均不需要改变，如果需要访问不同的环境，不同的分支，则可以修改项目配置文件bootstrap.yml中对应的属性：profile、label等，至于配置中心(config server)使用的是哪种方式存储配置，配置消费端（config client）无需关心，只管用即可。

　　2.4.实现配置信息自动刷新（可参见：）

　　2.4.1.在controller类（DemoController）上添加@RefreshScope注解，简单就不贴代码

　　2.4.2.在POM XML中添加actuator依赖，配置如下：

        <!--actuator监控功能所需依赖（内部包含refresh,动态刷新配置信息需要）-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>

　　2.4.3.在项目配置文件（bootstrap.yml或application.yml都可以）添加如下配置内容：

management:
  endpoints:
    web:
      exposure:
        include: "*" #暴露所有端口，也可以指定某一个环境（先management.endpoint.{profile}.enabled=true，然后这里指定这个{profile},多个用,分隔）

　　通过上述两步即完成config client端的自动监听与刷新机制（刷新原理参见：https://blog.csdn.net/cml_blog/article/details/78411312）

　　这时可以启动运行项目，然后POST请求访问：http://localhost:8008/actuator/refresh，如果能正常响应结果没有报404就OK了，响应内容为空？没关系，因为只有当config server端的配置文件有更新，这时POST这个API时，即会检测并响应返回更新的配置项信息，这样config client内部即可进行配置的刷新工作。到目前还没有实现全自动刷新配置，因为config server端配置文件有更新，config client端并不会第一时间感知到，如果不去POST请求refresh API则不会更新，所以自动更新的关键是如何能够实现配置中心的配置文件一旦更改就能通知所有的配置消费端（config client）自动更新配置信息。如果采用github的方式，那么可以使用github仓库的Webhooks功能，具体操作位置如下图示：

设置webhooks后，只要这个存配置的GIT仓库发生改变，将针触发事件并回调refresh接口（当然可以封装一个通用接口，然后里面把所有的 config client都调refresh接口），config client端收到刷新请求后就会重新从config server中获取配置信息。

虽然webhooks能够解决自动刷新问题，但仍不够优美，比较好的实现方式是再结合spring cloud bus、mq实现更好的自动刷新所有config client，具体可参见：https://www.cnblogs.com/willpan-z/p/9483674.html 、 https://blog.csdn.net/wtdm_160604/article/details/83720391

　　另外actuator还默认集成了健康检查功能，可访问：http://localhost:8866/actuator/health,即可看到响应结果，正常则为status=UP,否则可能是DOWN

　　2.5.加入到注册中心配置成高可用集群环境

 　　思路：我们可以把服务配置中心(config server)与服务消费客户端(config client)均作为服务加入到注册中心里面，然后服务消费客户端(config client)通过注册中心根据服务配置中心(config server)的服务ID（应用名称）找到config server IP,然后请求该IP即可。

　　前提：先把之前文章《玩转Spring Cloud之服务注册发现（eureka）及负载均衡消费（ribbon、feign）》中的eureka server项目正常启动；

　　2.5.1.改造服务配置中心(config server)，集成eureka client（这个我之前文章有说明）【操作步骤简要重述：先在POM XML中添加spring-cloud-starter-netflix-eureka-client依赖，然后在spring boot启动类上添加@EnableDiscoveryClient注解以便启用服务发现，最后在application.yml中添加eureka client的配置信息】，让其能够加入到注册中心中，如下是改造后的配置文件：（注释掉的是多种方式配置）--eureka 配置节点为新增

 

server:
  port: 8866

spring:
  application:
    name: configserver
  profiles:
    active: native #设置使用本地配置(默认是git,可以设置：subversion(SVN)，native(本地))
  cloud:
    config:
      server:
        #如下是GIT配置
#        git:
#          uri: https://github.com/zuowj/learning-demos     # 配置git仓库的地址（最后不需要带/，否则会出现：No custom http config found for URL: XXX）
#          search-paths: config                             # git仓库地址下的相对搜索地址（可用使用通配符），可以配置多个，用,分割。可以{application}实现按应用查配置
#          username:                                             # git仓库的账号（公开仓库无需账号信息）
#          password:                                             # git仓库的密码（公开仓库无需账号信息）
#          default-label: master                             #git默认分支

        #如下是SVN配置
#        svn:
#          uri: http://svnhost:port/svn/app-config #SVN仓库地址
#          username: svnuser #SVN账号(如果没有权限可为空)
#          password: svnpassword#SVN密码(如果没有权限可为空)
#          default-label: trunk #默认SVN分支

        #如下是本地文件配置
        native:
          search-locations: classpath:/configs #配置文件存放的目录

eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:8800/eureka/

　　2.5.2.改造服务消费客户端（config client），集成eureka client（同2.5.1的服务配置中心(config server)，集成eureka client步骤），让其能够加入到注册中心中，以便可以通过注册中心根据服务配置中心(config server)的服务ID（应用名称）找到config server IP,这里的eureka相关配置应统一在bootstrap.yml中，完整配置如下：

 

server:
  port: 8008

spring:
  application:
    name: configclient

  cloud:
    config:
      name: configclient #对应config server Url中的{application}
      profile: prod #配置环境，对应config server Url中的{profile}
      #label: trunk #配置分支(不配置则默认：git则是master,svn则是trunk)，
      #uri: http://localhost:8866 #配置中心地址
      discovery:
        enabled: true #启用服务发现
        service-id: configserver #指定要从eureka获取的config server的服务ID（即：configserverr的applicationName）

eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:8800/eureka/

 

如上配置，重点是spring.cloud.config.uri不再指定固定的config server IP,而是改成配置spring.cloud.config.discovery【服务发现】，eureka配置节点与所有eureka client基本相同不再重述。

都改造完成后，信次先后启动运行：服务配置中心(config server)【可以运多个实例以不同的端口号】、服务消费客户端（config client），发现一切都正常，当服务配置中心(config server)某个实例断开仍不影响服务消费客户端（config client），这样就实现了高可用了。

好了，有关spring cloud config 总结就写到这里了，很多细节若需深究的话还有很多，后面项目中有实际用到再补充总结吧。文中若有不足，欢迎指出，码字不易，请多支持，谢谢！　　

分享可参考链接：

https://springcloud.cc/spring-cloud-config.html

https://blog.csdn.net/qq_20597727/article/details/82465069

 

提示：本文相关示例项目代码均已上传到GITHUB，地址如下：

https://github.com/zuowj/learning-demos/tree/master/java/demo-configserver

https://github.com/zuowj/learning-demos/tree/master/java/demo-configclient

當幸福来敲门
关注
专栏目录
SpringCloud ConfigServer 配置中心搭建及实践
AI天才研究院
07-29 1220
Spring Cloud Config 提供了一种分布式系统配置管理解决方案。Spring Cloud Config 为微服务架构中的各个不同的微服务应用提供了集中化的外部配置管理。配置服务器从Git或Subversion存储库加载配置信息并集中管理它们。客户端通过指定要使用的配置服务器和应用程序名进行连接，并在启动时装载配置信息。
Spring Cloud Config实现分布式配置中心
08-27
Spring Cloud Config 实现分布式配置中心 ...Spring Cloud Config 提供了一种实现分布式配置中心的解决方案，使用 Config Server 管理配置文件，Config Client 获取配置文件，实现了配置文件的集中管理和动态更新。
SpringCloud——分布式配置中心 SpringCloud Config
时光·漫步的博客
07-10 249
1. 概述 1.1是什么 官网：https://cloud.spring.io/spring-cloud-static/spring-cloud-config/2.2.1.RELEASE/reference/html/ SpringCloud Config 为微服务架构中的微服务提供集中化的外部配置支持，配置服务器为各个微服务应用的环境提供了一个中心化的外部配置。 SpringCloud Config 分为服务端和客户端两部分。 服务端也称为分布式配置中心，它是一个独立的微服务应用， 用来连.
springboot上传文件到本地，并且返回一个http访问路径
最新发布
zlfjavahome的专栏
07-14 3783
springboot上传文件到本地，并且返回一个http访问路径
[SpringCould篇]之服务消费者方式Feign
程序员小强的博客
10-18 5640
1.前言 1.1调用服务的方式 Spring-Cloud调用服务有两种方式 Ribbon+RestTemplate Feign 本文主介绍Feign消费方式的使用，Feign是一个声明式、模板化的HTTP客户端，feign整合了ribbon,具有负载均衡的能力。 相关依赖版本 spring-boot - 2.1.4.RELEASE spring-cloud - Greenwich.SR1 1.2什么是feigin？优点？ feign采用的是基于接口的注解 feign整合了ribbon，具有负载均
文件上传的后端详解
博客
05-17 513
NiuaConfig 此时filePath就是 profile( C:/Users/10565/Desktop/niuniu/) + upload C:/Users/10565/Desktop/niuniu/upload FileUploadUtils2 把绝对路径中profile的部分(C:/Users/10565/Desktop/niuniu/)用(profile/)代替 的目的是防止服务器中的路径暴露到前端，用/profil...
SpringCloud之分布式配置中心Spring Cloud Config高可用配置实例代码
08-27
Spring Cloud Config是Spring Cloud中的配置中心模块，用于管理应用程序的配置信息。在生产环境中部署配置中心时，我们需要确保它是一个高可用的应用。Spring Cloud Config提供了两种方式来实现服务端的高可用：传统...
SpringCloud——分布式配置中心（Spring Cloud Config）
09-14
在微服务架构中，Spring Cloud Config 是一个强大的分布式配置中心，它允许开发人员将应用程序的配置存储在远程仓库中，并且可以在运行时动态地管理和更新这些配置，无需重启应用。这个特性对于大型分布式系统来说...
springcloud config配置中心
03-10
Spring Cloud Config 是一个用于微服务架构中的外部化配置服务器，它允许我们将应用程序的配置存储在远程仓库中，然后在运行时动态地为服务提供配置。这样可以方便地管理和更新多个环境（如开发、测试、生产）下的...
SpringCloud 之 统一配置中心 Config Server 的简单使用
weixin_36898373的博客
04-09 571
（此次创建的Demo小案例都是基于springBoot【2.0.0.M3】，springCloud【Finchley.M2】创建的，读者若是为了演示正常，请务必保持版本一致） 下面讲解统一配置中心的简单使用 1.创建一个config Server的项目，我们就叫config 2.然后我们继续下一步，一定要按照下图红框圈中的两项选择 3.然后修改我们的版本 4.因为我们演...
springcloud-06-ConfigServer基本用法
qq_40093255的博客
07-20 169
分布式面临的配问题： 微服务意味着要将单体应用中的业务分成一个个自服务，每个服务的粒度相对较小，因此系统中会出现大量的服务，由于每个服务都需要必要的 配置信息才能运行，所以一套集中式的、动态的配置管理设施是必不可少的。SpringCloud提供了ConfigServer来解决这个问题。我们每一个微服务自己都带着一个application.yml,上百个配偶文件的管理。。。该如何解决呢？ 分布式Co...
恼人的No mapping found for HTTP request with URI解决了
tanzhi963的博客
11-08 2万+
开始学习Spring MVC，代码和配置文件都是按照网上的教程一步一步来，检查了无数遍肯定没有敲错，但是放到Tomcat上一跑就报“No mapping found for HTTP request with URI” 网上搜了很多文章，说的方法基本是两个： 1、修改web.xml /*为/（去掉*） 2、给dispatcher-servlet.xml 添加 这些方法我都试验
Git使用及push过程中Username for 'https://github.com':解决
热门推荐
qq_43768946的博客
12-10 2万+
安装Git客户端及注册Github过程 在https://git-scm.com/downloads下载Git for windows这是一个git的windows系统的命令行版本. 在https://tortoisegit.org/download/下载 tortoise git这个是git的图形界面. 安装过程 先安装 git for windows, 再安装 tortoise git 安装...
SpringCloud-Config 搭建配置中心时遇到的坑
x_san3的博客
07-16 4979
先看配置文件： 问题1：config client启动Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured. 解决：1、检查datasource的一些相关配置信息是否正确 2、一般在配置中心有配置，没问题，客户端不想用或用不到可以启动类添加 @SpringBootAppl...
SpringCloud Config 配置中心详解及 Gitee 环境搭建
SpringCloud Config 配置中心 SpringCloud Config 是一个分布式配置中心，用于统一管理系统的配置文件。当系统配置文件发生改变的时候，系统会自动获取最新的配置文件。下面是 SpringCloud Config 的架构图： ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值