SpringBoot入坑指南之二:配置篇

开篇语

很多人都说,Spring Boot最大的作用就是简化配置,摆脱原来Spring的配置地狱。确实,相比Spring原来的配置,Spring Boot简直就是天堂,所以说Spring Boot就是一个又大又深的坑,跳进去了就再也出不来(你也不愿意出来),这也是这个系列文章为什么叫入坑指南的原因。
不过,任何应用都不可能摆脱配置,像数据库相关配置、业务自定义配置等就肯定需要进行配置的。所以,在本文主要讲一下Spring Boot的一些配置方式,主要参考官方文档和自己项目中的一些使用方式。

Spring Boot的配置文件

默认配置文件

Spring Boot默认的配置文件时application.yml(或application.properties),相对于properties文件,yaml格式层级结构清晰易于阅读和管理,故推荐使用yaml格式进行配置。需注意的是,当相同目录下同时存在application.properties和application.yml文件时,会优先读取properties文件中的配置。

application.properties/application.yml配置文件读取优先级顺序如下:

文件 优先级
(值越小优先级越高)
说明
file:./config/application.properties 1 Jar包所处的同级目录的下级config目录
file:./config/application.yml 2 Jar包所处的同级目录的下级config目录
file:./application.properties 3 Jar包所处的同级目录
file:./application.yml 4 Jar包所处的同级目录
classpath:./config/application.properties 5 ClassLoader根目录下级config目录
classpath:./config/application.yml 6 ClassLoader根目录下级config目录
classpath:./application.properties 7 ClassLoader根目录
classpath:./application.yml 8 ClassLoader根目录

上表只是在默认情况下,实际上你可以通过spring.config.location配置修改配置文件读取路径,该配置既可以直接指定读取的配置文件,也可以指定配置文件的目录,如果需要指定目录,配置值必须是斜杠“/”结尾。
比如将配置设置为spring.config.location=classpath:./custom_location/,file:./custom_location,那么读取的优先级顺序会变成:file:./custom_locationclasspath:./custom_location

需注意的是,spring.config.location配置需在环境变量或者命令行参数中进行配置。

其他配置方式

Spring Boot还可以通过环境变量或者命令行参数进行应用配置,这两种配置方式优先级高于配置文件,即:
命令行参数>>环境变量>>application.properties>>application.yml
这两种配置方式在实际应用中有很大的用处,特别是用于多环境配置文件切换,下文会进行介绍。

多环境配置

如何管理多环境配置

软件开发过程中,会涉及到开发、测试、灰度、生产等各部署环境,每个环境所需要的配置肯定会有差异,不同环境的配置文件怎么管理?CI/CD过程如何切换?
Spring Boot框架提供了多环境配置文件管理的解决方式,上文说到,Spring Boot默认的配置文件是application.yml,你可以按application-{profiles}.yml创建多个配置文件如:

  • application-dev.yml
  • application-test.yml
  • application-prod.yml
    之后在application.yml主配置文件中通过spring.profiles.active配置参数指定启用的profiles即可。

多环境配置切换方式

上面说的是如何管理多环境配置,配置文件配置好了,如何在持续集成的流程中进行配置文件的动态切换呢?我接触的项目中,注意是以下几种方式,给大家介绍一下。

方式一:原始方式(手工切换,非常Low,不推荐)

  • 实现方式
    如题,就是构建的时候手动将spring.profiles.active配置给改了,或者保证测试、或生产代码分支下该配置不变。

  • 优点

    • 只有一个:简单粗暴。
  • 缺点

    • 如果忘记改了或者合并分支的时候被覆盖,那就问题大了。
    • 测试、生产环境保存在源码中,安全性较低。

方式二:使用Maven变量

注意:使用maven变量时,项目的父项目需要是“spring-boot-starter-parent”,否则需要额外增加配置,可参考:https://docs.spring.io/spring-boot/docs/2.1.2.RELEASE/reference/htmlsingle/#howto-automatic-expansion

  • 实现方式
    (1).在项目pom.xml文件中增加profiles配置,配置参考如下:
<!-- 不同环境查找不同配置文件 -->
    <profiles>
        <profile>
            <id>dev</id>
            <properties>
                <profiles.active>dev</profiles.active>
                <maven.test.skip>true</maven.test.skip>
            </properties>
            <activation>
                <!-- 默认环境变量 -->
                <activeByDefault>true</activeByDefault>
            </activation>
        </profile>
        <profile>
            <id>test</id>
            <properties>
                <profiles.active>test</profiles.active>
                <maven.test.skip>true</maven.test.skip>
            </properties>
        </profile>
        <profile>
            <id>prod</id>
            <properties>
                <profiles.active>prod</profiles.active>
                <maven.test.skip>true</maven.test.skip>
            </properties>
        </profile>
    </profiles>

(2).修改application.yml中的spring.profiles.active配置,使用maven变量替换。

spring:
  profiles:
    active: @profiles.active@

(3)..maven构建时通过参数指定替换变量,如下:

mvn clean package -Pprod
  • 优点
    • 构建时指定,只需调整持续集成逻辑即可。
    • 实现简单,符合软件部署逻辑。
  • 缺点
    • 测试、生产环境保存在源码中,安全性较低。

方式三:利用配置文件读取优先级(推荐)

  • 实现方式
    Spring Boot一般来说都是通过构建Jar包进行部署(war包部署请绕路),参考上面介绍的配置文件读取路径优先级顺序,在测试/生产服务器对应的部署路径中放置对应环境的application配置文件,部署的时候直接将Jar部署到对应目录,启动时就会使用外部的配置。

  • 优点

    • 测试、生产等环境配置文件无需放到代码中,避免泄漏。
    • 应用构建、部署过程无需处理配置。
    • 测试、生产的配置文件只存在于服务器上面,只有服务器相关运维人员能够查看和修改,安全性较高。
  • 缺点

    • 只适合服务器相对固定的场景,对于使用容器分布式弹性部署的场景不适用。
    • 如果应用增加或修改配置,需要到各个服务器进行修改。

方式四:应用启动时指定(推荐)

  • 实现方式
    在Spring Boot应用启动时,通过命令行参数指定启用的profiles,由于命令行参数优先级高于配置文件,故生效的是命令行中指定的profiles。
    参考启动命令如下:
# 启用test profiles
java -jar target/spring-boot-examples-properties-1.0-SNAPSHOT.jar --spring.profiles.active=test
  • 优点

    • 无需关注打包过程,只需要在服务启动命令中设置后启动参数即可。
    • 配置文件可以保存在源码中,也可以保存在服务器中(参考上文方式三)。
  • 缺点
    暂无

本文示例代码

码云:https://gitee.com/centy/spring-boot-examples/tree/master/spring-boot-examples-properties

尾巴

通过Spring Boot可以快速构建一个微服务,那么微服务的服务治理就不得不提Spring Cloud全家桶,Spring Cloud提供各种配置中心解决方案(Spring Cloud Config、Consul、Zookeeper等)。
通过配置中心管理各个微服务的配置,开发、测试环境与生产的配置中心分离,就可以无需关注单个服务的不同环境配置的切换了,是不是很爽?
但是还有一个问题,每个微服务需要指定配置中心的地址,这个地址还是需要切换不是吗?有没有方法可以不切换这个配置呢?实际不用考虑的那么复杂,有很简单的方式,如果你是通过Docker容器部署应用的,通过设置容器环境变量指定配置中心的访问地址就可以了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,496评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,407评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,632评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,180评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,198评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,165评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,052评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,910评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,324评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,542评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,711评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,424评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,017评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,668评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,823评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,722评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,611评论 2 353

推荐阅读更多精彩内容

  • SpringMVC原理分析 Spring Boot学习 5、Hello World探究 1、POM文件 1、父项目...
    jack_jerry阅读 1,286评论 0 1
  • https://github.com/cuzz1/springboot-learning 一、Spring Boo...
    cuzz_阅读 3,435评论 1 6
  • 此篇翻译的是Spring Boot官方指南 Part III. 使用 Spring Boot (Using Spr...
    K天道酬勤阅读 6,747评论 0 21
  • springboot 概述 SpringBoot能够快速开发,简化部署,适用于微服务 参考嘟嘟大神SpringBo...
    一纸砚白阅读 5,420评论 2 20
  • 杨扬3岁到3岁两个月期间,喜欢读车牌,特别喜欢走地库,指着一个个的车牌不厌其烦地问,妈妈,这个是什么?我回答后,他...
    童杨阅读 303评论 0 0