spring cloud 2.x版本 Config配置中心教程

時間 2019-11-06

標籤 spring cloud 2.x 版本 config 配置中心教程欄目 Spring 简体版

原文原文鏈接

前言

本文采用Spring cloud本文爲2.1.8RELEASE，version=Greenwich.SR3 java

本文基於前面的文章eureka-server的實現。參考git

eureka-server

概述

在分佈式系統中，因爲服務數量巨多，爲了方便服務配置文件統一管理，因此須要分佈式配置中心組件。Spring Cloud Config爲分佈式系統中的外部化配置提供服務器和客戶端支持。github

本篇涉及項目的結構爲一個Config Server單機模式和適用於連接Git倉庫，一個Config Client經過server來展現配置文件數據。同時使用兩個bus來模擬配置文件刷新。web

建立config-server工程

Config-server功能算法

用於外部配置的http，基於資源的api
加密和解密屬性
使用可嵌入spring boot的應用程序

1.1 建立配置中心server：config-server

1.2 添加config-server的pom.xml相關依賴

<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-config-server</artifactId>
</dependency>
<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
複製代碼

1.3 添加config-server的application添加配置信息

#加載本地文件配置
spring:
 application:
 name: config-server
 profiles:
 active: native #加載本地配置
 cloud:
 config:
 server:
 native: #加載本地目錄文件
 search-locations: /Users/xxxx/config-server

server:
 port: 13081

eureka:
 instance:
 hostname: eureka1.client.com
 lease-renewal-interval-in-seconds: 5
 lease-expiration-duration-in-seconds: 10
 client:
 service-url:
 defaultZone: http://eureka1.server.com:8701/eureka/,http://eureka2.server.com:8702/eureka/,http://eureka3.server.com:8703/eureka/
複製代碼

1.4 啓動類ConfigServerApplication增長註解

package spring.cloud.demo.configserver;

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);
    }

}
複製代碼

至此，一個單機本地config-server就搭建完成spring

1.5 建立配置中心client：config-client

1.6 添加config-client的pom相關依賴

<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-config</artifactId>
</dependency>
<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
複製代碼

1.7添加config-client的bootstrap.yml相關配置(注意這裏不是application.yml)

bootstrap.ymljson

spring:
 application:
 name: config-client
 cloud:
 config:
 label: master
 profile: dev
 fail-fast: true
 uri: http://localhost:13081 #經過域名訪問配置中心服務端
 discovery:
 enabled: true
eureka:
 instance:
 hostname: eureka1.client.com
 lease-renewal-interval-in-seconds: 5
 lease-expiration-duration-in-seconds: 10
 client:
 service-url:
 defaultZone: http://eureka1.server.com:8701/eureka/,http://eureka2.server.com:8702/eureka/,http://eureka3.server.com:8703/eureka/
複製代碼

1.8新建從服務端請求的配置文件config-client-dev.yml

客戶端從服務端獲取資源配置的路徑規則：bootstrap

/{application}/{profile}[/{label}]

/{application}-{profile}.yml

/{label}/{application}-{profile}.yml

/{application}-{profile}.properties

/{label}/{application}-{profile}.properties

本文采用第二種規則。api

配置內容：服務器

spring:
 application:
 name: config-client

server:
 port: 52601

eureka:
 instance:
 hostname: eureka1.client.com
 lease-renewal-interval-in-seconds: 5
 lease-expiration-duration-in-seconds: 10
 client:
 service-url:
 defaultZone: http://eureka1.server.com:8701/eureka/,http://eureka2.server.com:8702/eureka/,http://eureka3.server.com:8703/eureka/

info: local-config-client-dev
複製代碼

將新建的config-client-dev.yml放到config-server配置的/Users/xxxx/config-server目錄下，若是config-server沒有配置目錄，默認使用resources目錄下。

1.9 ConfigClientApplication增長註解

package spring.cloud.demo.configclient;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@EnableDiscoveryClient
@SpringBootApplication
public class ConfigClientApplication {

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

}

複製代碼

2.0 建立測試類

在config-client建立測試Controller：ConfigClientController

package spring.cloud.demo.configclient.controller;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/** * 測試是否能獲取到配置信息的controller * @auther: maomao * @DateT: 2019-09-17 */
@RestController
public class ConfigClientController {

    @Value("${info}")
    private String info;

    @RequestMapping("/config/info")
    public String info() {
        return info;
    }

}
複製代碼

2.1 啓動相關服務

分別啓動eureka-server、config-server、config-client。訪問：http://localhost:52601/config/info，顯示以下

證實本地配置文件已經生效。

2.2 從遠程git加載資源配置文件

修改config-server的application.yml配置文件：

##加載本地文件配置
#spring:
# application:
# name: config-server
# profiles:
# active: native #加載本地配置
# cloud:
# config:
# server:
# native: #加載本地目錄文件
# search-locations: /Users/fengfujie/config-server

#加載遠程git倉庫資源文件
spring:
 application:
 name: config-server
 cloud:
 config:
 server:
 git:
          # 配置git倉庫的地址
 uri: https://github.com/fengfujie25/sping-cloud-config
          # git倉庫的帳號
 username: xxxxxx
          # git倉庫的密碼
 password: xxxxxx

server:
 port: 13081

eureka:
 instance:
 hostname: eureka1.client.com
 lease-renewal-interval-in-seconds: 5
 lease-expiration-duration-in-seconds: 10
 client:
 service-url:
 defaultZone: http://eureka1.server.com:8701/eureka/,http://eureka2.server.com:8702/eureka/,http://eureka3.server.com:8703/eureka/
複製代碼

從新啓動config-server服務。而後刷新http://localhost:52601/config/info地址，顯示以下

證實已經成功獲取了遠程git資源的配置信息。

2.3 經過服務名稱訪問config-server

以上配置都是經過域名訪問的config-server，爲了保證系統的高可用，由於生產環境的配置服務中心都是集羣配置，全部客戶端才經過服務名稱來訪問。

修改config-client的bootstrap.yml

spring:
 application:
 name: config-client
 cloud:
 config:
 label: master
 profile: dev
 fail-fast: true
      #uri: http://localhost:13081 #經過域名訪問配置中心服務端
 discovery:
 enabled: true
 service-id: config-server #經過服務訪問配置中心服務端

eureka:
 instance:
 hostname: eureka1.client.com

 lease-renewal-interval-in-seconds: 5
 lease-expiration-duration-in-seconds: 10
 client:
 service-url:
 defaultZone: http://eureka1.server.com:8701/eureka/,http://eureka2.server.com:8702/eureka/,http://eureka3.server.com:8703/eureka/
複製代碼

spring.cloud.config.discovery.service-id：經過服務名稱訪問配置中心服務端

從新啓動config-client.並訪問http://localhost:5301/config/info，顯示結果同【2.2】則表明配置信息已生效，證實是經過服務名稱訪問的config-server.

至此，spring cloud集成config的配置就所有完成。可是存在一個問題，若是修改遠程git倉庫的資源配置，項目並不會刷新，因此配置信息是不生效的。

2.4 動態刷新config-server配置

動態刷新config-serve配置方式

基於RabbitMQ動態刷新
原生刷新（僞動態刷新）

本文采用比較簡單的原生刷新方式。

2.4.1增長相關pom.xml依賴

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
複製代碼

2.4.2 在ConfigClientController增長@RefreshScope註解

package spring.cloud.demo.configclient.controller;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/** * @auther: maomao * @DateT: 2019-09-17 */
@RestController
@RefreshScope
public class ConfigClientController {

    @Value("${info:error}")
    private String info;

    @RequestMapping("/config/info")
    public String info() {
        return info;
    }

}
複製代碼