Spring Cloud Config 使用说明(1) -- 快速开始

ゞ浴缸里的玫瑰 2022-11-28 13:36 84阅读 0赞

**2.2.4.RELEASE**

Spring Cloud Config为分布式系统中的外部配置提供服务器和客户端支持。使用Config Server，您可以在所有环境中管理应用程序的外部属性。客户端和服务器上的概念映射与Spring 的Environment和PropertySource的抽象相同，因此它们与Spring应用程序非常契合，但可以与任何以任何语言运行的应用程序一起使用。随着应用程序通过从开发人员到测试和生产的部署流程，您可以管理这些环境之间的配置，并确定应用程序具有迁移时运行需要的一切。服务器存储后端的默认实现使用git，因此它轻松支持标签版本的配置环境，以及可以访问用于管理内容的各种工具。可以轻松添加替代实现，并使用Spring配置将其插入。

# 快速开始 #

本节快速说明spring cloud config 的服务端和客户端的使用。

[下载服务器示例代码][Link 1]

首先，启动服务器，如下：

$ cd spring-cloud-config-server
    $ ../mvnw spring-boot:run

服务端是一个spring boot应用，因此也可以在IDE中启动（main class是ConfigServerApplication）。

然后试一下客户端，如下：

$ curl localhost:8888/foo/development
    { "name":"foo","label":"master","propertySources":[
      { "name":"https://github.com/scratches/config-repo/foo-development.properties","source":{ "bar":"spam"}},
      { "name":"https://github.com/scratches/config-repo/foo.properties","source":{ "foo":"bar"}}
    ]}

定位资源的默认策略是先克隆一个git仓库（在spring.cloud.config.server.git.uri），然后使用它来初始化一个SpringApplication。该应用程序的Environment用于枚举属性源并通过接口以JSON格式发布。

该HTTP服务中具有以下路径的资源：

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

其中“application”是SpringApplication中的spring.config.name（在常规的Spring Boot应用程序中通常为“application”），“profile”是活动的配置文件（或逗号分隔的列表），“label”是可选的git标签（默认为“master”）。

Spring Cloud Config服务器可以从多种数据源中拉取配置。下面的例子是从git服务器获取配置（必须提供）：

spring:
      cloud:
        config:
          server:
            git:
              uri: https://github.com/spring-cloud-samples/config-repo

也可以从jdbc数据库、Subversion、Hashicorp Vault、 Credhub和本地文件中获取配置

## 客户端使用 ##

要使用这些功能，你可以新建一个依赖于spring-cloud-config-client 库的Spring Boot应用。最方便添加依赖的方式是添加库org.springframework.cloud:spring-cloud-starter-config。Maven用户或使用Gradle和Spring CLI的Spring IO版本管理属性文件的用户也 可以 继承 spring-cloud-starter-parent。

**pom.xml**

<parent>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-parent</artifactId>
           <version>{spring-boot-docs-version}</version>
           <relativePath /> 
       </parent>
    
    <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>
    
    <dependencies>
    	<dependency>
    		<groupId>org.springframework.cloud</groupId>
    		<artifactId>spring-cloud-starter-config</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>

现在你可以创建一个标准的Spring Boot程序， 比如下面的http服务器：

@SpringBootApplication
    @RestController
    public class Application { 
    
        @RequestMapping("/")
        public String home() { 
            return "Hello World!";
        }
    
        public static void main(String[] args) { 
            SpringApplication.run(Application.class, args);
        }
    
    }

上面的http服务器运行的时候，会默认从本地8888端口的配置服务器中拉取外部配置。如果要改变配置服务器的地址，你可以修改bootstrap.properties文件（类似于application.properties，但作用于应用程序的启动阶段）中的配置中心地址属性，如：

> spring.cloud.config.uri: http://myconfigserver.com

默认情况下，如果没设置应用程序名，会使用“application”。要改变名字，可以在bootstrap.properties文件中添加配置

> spring.application.name: myapp

设置应用名称的时候，不要使用“application-”开头，防止解释属性源的时候出错。

bootstrap属性可以在/env接口中获取，是一个高优先级的属性源，如下：

$ curl localhost:8080/env
    { 
      "profiles":[],
      "configService:https://github.com/spring-cloud-samples/config-repo/bar.properties":{ "foo":"bar"},
      "servletContextInitParams":{ },
      "systemProperties":{ ...},
      ...
    }

一个叫configService:/的属性源，包含一个名叫foo、值为bar的属性，同时它是最高优先级的

> 上面的属性源中URL是指git服务器地址，不是配置中心的地址

[Spring Cloud Config 使用说明(1) – 快速开始][Spring Cloud Config _1_ _]  
[Spring Cloud Config 配置中心使用说明(2) – 服务器+git库][Spring Cloud Config _2_ _ _git]  
[Spring Cloud Config 配置中心使用说明(3) – 服务器+文件存储][Spring Cloud Config _3_ _]  
[Spring Cloud Config 配置中心使用说明(4) – 服务器+数据库存储][Spring Cloud Config _4_ _]  
[Spring Cloud Config 配置中心使用说明(5) – 服务器健康与安全配置][Spring Cloud Config _5_ _]  
[Spring Cloud Config 配置中心使用说明(6) – 服务器 配置文件格式][Spring Cloud Config _6_ _ _]  
[Spring Cloud Config 配置中心使用说明(7) – 服务器 配置变更通知][Spring Cloud Config _7_ _ _]  
[Spring Cloud Config 配置中心使用说明(8) – 客户端][Spring Cloud Config _8_ _]

[Link 1]: https://github.com/spring-cloud-samples/configserver
[Spring Cloud Config _1_ _]: https://blog.csdn.net/xgw1010/article/details/108067033
[Spring Cloud Config _2_ _ _git]: https://blog.csdn.net/xgw1010/article/details/108112195
[Spring Cloud Config _3_ _]: https://blog.csdn.net/xgw1010/article/details/108307758
[Spring Cloud Config _4_ _]: https://blog.csdn.net/xgw1010/article/details/108311633
[Spring Cloud Config _5_ _]: https://blog.csdn.net/xgw1010/article/details/108332736
[Spring Cloud Config _6_ _ _]: https://blog.csdn.net/xgw1010/article/details/108422497
[Spring Cloud Config _7_ _ _]: https://blog.csdn.net/xgw1010/article/details/108426947
[Spring Cloud Config _8_ _]: https://blog.csdn.net/xgw1010/article/details/108428446