摘要:对于一个合格的CloudNative应用,应该把本身的程序当作开源软件来编写的,不应将数据库链接信息和密码放在代码里,必定要将配置外置。
本文分享自华为云社区《[CloudNative] 企业应用上云实践手记-Cloud Native Phase 3 - 云原生应用AutoConfig》,做者:关耳山石html
对于一个合格的CloudNative应用,应该把本身的程序当作开源软件来编写的,不应将数据库链接信息和密码放在代码里,必定要将配置外置。java
所以我试着在华为云上落地这套标准,期间尝试了从ServiceStage、CCE、CSE这三个入口进行配置注入,最终实现可以在应用启动时,主动拉取配置,覆盖本地配置文件里的调试配置,并可以在线配置并生效。git
打法是:CCE配置启动参数,制定SpringProfiles;配合CSE作应用配置,将资源外置后的配置记录于此,并能够动态更新,最终实现了配置外置的诉求。github
另外,经过此次增长的多版本管理,尝试梳理了一下ServiceStage的组件、CCE的workload、CSE的应用和微服务之间,错综复杂的概念之间的关系,我的浅见,欢迎指正:spring
1. 初始化配置
在系统初始化的时候,不可能一点配置都没有,因此保留一些基础配置在配置文件里是有必要的。配置外置并不意味着100%的配置都要外置,而是把外部依赖资源的配置,特别是容易变化配置外置。数据库
1.1 启用Bootstrap和Spring profile
在代码层面,首先要进行基础配置。先看代码结构,这里除了最基本的application.yaml,增长了bootstrap.yaml和*-dev.yml等带后缀的文件。bootstrap
介绍一下原理:缓存
- 首先介绍Bootstrap Application Context:
它是Spring Cloud Context的父Context,因此从外部配置源里加载配置通常从这里来,且优先级高于其余一切配置文件。因而,咱们也利用这个能力,借助CSE的微服务配置中心能力,进行Spring的外部参数写入。
- 而后介绍Spring profiles:
为了把通用配置和环境相关的配置区分开,好比DEV环境没有AK/SK认证,而线上环境都有认证,这种配置项上的区别,引入了Spring profiles的概念,当Springboot启动的时候,会根据profiles.active参数判断应该启用那个环境配置
PS:参考SpringCloud官方解释app
另外,就是哪些配置应该放在配置文件里,理论上除了最基础的配置,在启动时使用的,其他的配置均可以放在CSE的微服务配置中内心,而没必要在本地配置文件里存在,另外就是本地配置里存在的,也能够经过二次设置在微服务的配置中内心,进行覆盖,好比数据库链接池的大小,而不须要修改代码,至于改完之后,要不要重启,那就得看生效的逻辑了。分布式
1.2 引入CSE配置中心
CSE配置中心引入,须要先引入依赖包,而后在bootstrap.yaml中配置CSE配置中心的地址、认证信息等。
这里能够参考官方文档,主要关注bootstrap.yaml的配置参数: 使用分布式配置中心
补充:获取spring-cloud-starter-huawei-config的版本
参考地址:huaweicloud/spring-cloud-huawei
能够参考现有的SpringCloud基线版本,选择SpringCloud-Huawei的版本
补充:关于配置中心的优先级
微服务引擎提供了分层次的配置机制。按照优先级从高到低,分为:
- 配置中心(动态配置)
- Java System Property(-D参数)
- 环境变量
- 配置文件
参考官方文档:配置微服务
2. 本地CSE配置中心能力验证
前提条件,本地得安装一个Local-CSE并启动, 这部分参考云上DevOps:2.1-本地环境准备
2.1 配置application.yaml和bootstrap.yml
原始文件能够参考Github的Demo, 配置文件入口, 我这里进行了修改,由于bootstrap.yaml优先级高于application.yaml,参数只要在bootstrap.yaml中出现过,就不会使用application.yaml中的配置了。
上代码,application.yaml,能够看到配置不多,由于大部分bootstrap.yml中已经包含,就都去掉了
这是bootstrap.yml,注意这里的spring.application.name、spring.cloud.servicecomb.discovery.appName和spring.cloud.servicecomb.discovery.version会组成一个微服务私有的参数做用域,这里的优先级高于全局做用域application。特别注意,云上的CSE环境,除了上面提到的,还须要增长server.env参数。另外,server.env有四个参数能够选development、testing、acceptance、production
关于如上参数的定义, 参考官方文档:使用分布式注册中心和官方文档:使用分布式配置中心。
2.2 准备验证代码
直接上代码
2.3 静态配置能力
为了验证CSE配置中心的参数,是否能覆盖application.yaml中的参数配置,我选了一个很特别的参数:spring.datasource.password,若是可以覆盖成功,那么启动后,建立数据库链接池必定会报错。
- 首先,打开本地CSE配置中心,地址为:http://localhost:30106/#/cse/services/config,建立一个配置项,做用域选VodMgrService@CabgOne#1.0.0,关于application的做用域后面再解释。
- 重启本地微服务,启动后建立数据库链接池就报错了,符合预期。
结论:CSE配置中心的参数,可以覆盖application.yaml中的参数配置
2.4 动态配置能力
为了验证CSE配置中心的参数动态生效,须要使用注解@RefreshScope,同时也引入ConfigRefreshEvent来监听事件变化,这样就会获得一个效果,对于动态生效的参数,可能须要一些重建或刷新,好比链接池、缓存、Client等。
- 首先,增长一个配置项config.value
- 而后很快能够看到后台日志打印出来,包括本身的监听器,也响应了日志
- 查看一下数据,已经响应为TryMe
- 具体的配置,在后台是轮询的,响应周期配置参数为cloud.servicecomb.config.watch.delay,目前是10秒一次
- 修改一下配置,为TryMeAgain
- 再看后台日志,有新的触发器发生
- 再次请求API,数据已经更新
- 再深刻去看,这里的getChange()返回是一个Set<String>,所以能够针对特定的参数作文章。
结论:本地CSE配置中心的参数可以动态刷新,并开放了ConfigRefreshEvent,以扩展配置更新后的业务动做。
2.5 配置的做用域限制
目前CSE的配置中心提供两级做用域限制,一个是全域,一个是私域,即微服务内部(不一样版本有区分)。
- 增长一个做用域为application的全域参数,一个做用域为VodMgrService@CabgOne#1.0.0的私域同名参数
- 验证一下,生效的做用域是VodMgrService@CabgOne#1.0.0
- 删除私域参数后,生效的做用域是application
结论:本地CSE配置中心的全域配置的优先级,低于微服务内部配置,即私域配置能够覆盖全域配置。
3. 云上配合外置落地
3.1 代码提交并自动打包推送SWR
代码提交,推送到CodeHub上,流水线在CloudPipeline自动驱动起来,开始执行,打包、制做镜像、推送SWR,而且展开了代码质量检查。 这些得益于前面的WIKI:Phase2 - 云上DevOps
3.2 CCE启动参数配置
因为ServiceStage的自动部署能力还不知足,因此手工将DockerImage升级到环境上,这里直接使用CCE进行操做,缘由在题记里介绍了,ServiceStage的参数配置不太好用
3.2.1 利用CCE的容器启动命令写入参数
- 选择升级版本,点高级配置,CCE的核心配置入口都在这里了
- 在启动时,注入最核心的一个参数-Dspring.profiles.active=uat
- 此处的命令是Docker启动是的ENTRYPOINT,下面那个是CMD,会覆盖Dockerfile里的命令
- 点击右下角的提交,会看到实例列表中已经有一个新的pod在启动
- 回到AOM服务,查看日志,会发现The following profiles are active: uat,符合预期
3.3 CCE环境变量配置
3.3.1 利用CCE的环境变量写入参数
- 首先回退上面那一步的配置,进入高级设置->环境变量
- 增长环境变量JAVA_TOOL_OPTIONS,值设置为-Dspring.profiles.active=uat
- 提交之后查看日志,符合预期
至于为啥JAVA_TOOL_OPTIONS能用,由于JVM原生就包含这个参数,能够用来在启动时写入配置,能够参考Oracle的官方文档
3.4 CCE配置中心
3.4.1 利用CCE的配置中心 + 环境变量写入参数
CCE的配置中心包含了两个大类,配置项ConfigMap和秘钥Secret,前面介绍的CCE环境变量,支持从配置中心导入参数,好比我能够在ConfigMap里写入这个参数,而后在CCE的环境变量中引入。
- 首先建立一个配置项,这里的配置项是按照集群、命名空间区分的
- 而后建立一套配置项,输入一套KV
- 回到CCE升级的步骤,修改环境变量,增长一项配置项写入的变量,能够选到刚才输入的KEY,就不用输入VALUE了
而后再看看秘钥,玩儿法相似,可是有一点很“有趣”:这里的秘钥是要主动用BASE64转码过才能保存,不过在使用的时候,会解密的,所以没必要关心转码回来的问题。
3.4.2 利用CCE的配置中心 + 数据存储写入参数
不管是配置项ConfigMap仍是秘钥Secret,均可以支持利用CCE的数据存储挂载能力写入参数到容器里,简单理解,就是会自动帮你把配置下载到一个容器的存储位置上,文件名是KEY,内容是VALUE,能够在代码里读取这个配置。
配置方式很简单,选择配置项,而后写一个挂载目录便可
3.5 云上CSE配置中心
这里是另外一个核心,线下验证过,云上的CSE相似,可是配置模型更复杂,增长了server.env维度,而且全域和私域参数配置位置不同。
- 首先,从ServiceStage->微服务CSE->配置管理,进入全域配置页面,选择环境为yaml里配置的server.env参数
返回结果为,生效
PS:若是这里不选环境,则参数没法读取,即环境为空也是一类环境,不一样环境之间隔离
- 而后,从ServiceStage->微服务CSE->微服务目录,进入私域页面
进而选择动态配置,在配置做用域时,选择不带version的,环境是固定值,
返回结果为,生效
- 一样的页面下,在配置做用域时,选择带version的,
返回结果为,生效
总结:云上CSE配置中心参数加载优先级
- P1:微服务私域,带Version
- P2:微服务私域,无Version
- P3:全域,带环境
其他参数都不生效,包括全域无环境、全域不一样环境、微服务私域不一样Version
总结
综上,基于华为云ServiceStage、CCE、CSE的配置外置能力,能够支撑微服务在不一样环境中灵活部署,而无需修改代码。目前的总结打法是:
- 利用CCE的容器启动参数,或环境变量,写入profiles.active参数
- 利用CSE的配置中心,写入业务参数,如MySQL链接串、链接池配置、GES引擎地址、VOD服务Endpoint地址等