应用配置

最近更新时间:2019-06-06 20:06:30

操作场景

应用配置功能有两个入口,一个入口是在单个应用的应用详情页内,另一个入口是在配置管理模块的应用配置。应用配置功能仅针对 Spring Cloud 应用生效,应用配置支持如下功能:

  • 创建配置项:一个配置项管理多个版本的配置。
  • 生成新版本:基于历史版本生成新版本。
  • 发布配置:支持发布配置到部署组。
  • 发布情况:查看配置项的发布到哪些部署组。
  • 回滚:回滚到上一个版本的配置。

前提条件

在使用控制台的应用配置功能前,请确保已经按照 分布式配置 配置了相关依赖项。

操作步骤

创建配置

  1. 登录 TSF 控制台
  2. 在左侧导航栏,单击【配置管理】>【应用配置】。
  3. 在应用配置页面顶部,选择目标应用。
  4. 在配置列表标签页,单击【新建】。
  5. 填写配置内容。
    • 配置项名:填写配置名。
    • 配置内容:按照 YAML 格式。YAML 格式规范参考 YAML 格式介绍
    • 版本号:填写初始版本号。
    • 版本描述:填写初始版本的描述。
  6. 单击【完成】。

    注意:

    单个应用配置版本的大小不能超过65535个字节,如果应用的配置超过了该上限值,可以分成多个应用配置项发布到同一个部署组,多个配置会合并成一份配置。

生成新版本配置

  1. 在配置列表页,单击目标配置名称,进入详情页。

  2. 在配置版本标签页,单击某个配置版本旁的【生成新版本】按钮。

  3. 填写变更的新版本的配置内容和版本号。

    注意:

    新版本配置的版本号不能与原版本相同。

  4. 单击【完成】。

发布配置

用户可以可以发布配置项的某个版本到部署组上。

  1. 在配置列表页,单击目标配置名称,进入详情页。
  2. 在配置版本标签页,单击某个配置版本旁的【发布】。
  3. 选择配置发布的目标部署组,填写发布描述。
  4. 单击【提交】。

配置合并逻辑说明

按照配置下发时间来排序执行合并(merge)。不同名的配置项中如果存在相同 key 会进行合并。合并规则:按照配置下发时间排序,离当前时间近的优先级较高。举例如下:

1. 创建配置项 config-abc,配置内容是 custom-key: value-1,发布时间 15:00:00
2. 创建配置项 config-bcd,配置内容是 custom-key: value-2, 发布时间15:00:01

最终在实例上生效的配置:custom-key: value-2

查看配置发布历史

用户可以在【配置发布历史】页面查看应用下部署组的配置发布记录。

  1. 在左侧导航栏,单击【配置管理】>【应用配置】>【配置发布历史】。
  2. 页面顶部选择【关联应用】,查看该应用下部署组的配置发布记录。

回滚配置

回滚配置会将部署组的配置回滚到上一次发布的版本。

  1. 单击【配置发布历史】标签页。
  2. 在配置发布历史列表中,单击右侧的【回滚】。
  3. 填写回滚说明,单击【提交】。