迁移配置到ACM的首要问题是确定哪些配置适合放入配置中心。这涉及到两个关键维度：时效性和安全性。
**时效性：静态与动态配置**
首先，静态配置指的是在程序发布后基本不会改变的配置，如软件版本号、日志样式、三方软件LicenseKey和PaaS平台连接串等。这些配置一般不需要频繁更改，可以存放在本地文件中。
动态配置则涉及程序运行时的变化，如限流降级参数、监控报警阈值、日志打印级别和容灾多活等。这些配置可能需要根据实际工作负载动态调整，因此更适合存放在配置中心，以增强应用的灵活性和实时性。
**安全性：非敏感与敏感配置**
其次，非敏感配置通常指的是技术类配置，即使泄露也不会引起安全问题，例如软件版本号、日志样式和限流降级参数等。这些可以安全地存放在配置中心。
敏感配置则与业务数据紧密相关，一旦泄露可能导致安全隐患，如三方软件LicenseKey和PaaS平台连接串。这些配置需要特别保护，最好在配置中心中加密存储，并通过严格鉴权来限制访问。
**迁移Spring框架配置**
对于使用Spring框架的Java应用，迁移配置通常涉及几个关键步骤。假设我们有以下配置：
```java @Configuration@ComponentScan("com.alibaba") @PropertySource("classpath:myApp.properties") public class AppConfig { @Value(value="${url}") private String URL; @Value(value="${dbuser}") private String USER; // 省略其他配置... } ```
为了迁移到ACM，我们需要执行以下操作：
1. 在ACM控制台创建配置项`myapp.dbconfig.properties`并添加相关配置内容。 2. 在项目的`pom.xml`文件中添加ACM的SDK依赖。 3. 在`AppConfig`类中增加ACM的配置注解，以从ACM获取动态配置。
```java @Configuration@ComponentScan("com.journaldev") @PropertySource("classpath:myApp.properties") @EnableNacosConfig(globalProperties = @NacosProperties(endpoint = "acm.aliyun.com", namespace = "xxx", AccessKey = "xxx", secretKey = "xxx")) @NacosPropertySource(dataId = "myApp.dbconfig.properties", autoRefreshed = true) public class AppConfig { @Value(value="${url}") private String URL; // 省略其他配置... } ```
这样，我们就能够通过ACM SDK实现Spring的配置动态刷新，而无需修改大量代码。
**注意事项**
在实际操作中，有几个要点需要注意：
- ACM SDK的选择：这里使用的是Nacos SDK，因为ACM无缝兼容Nacos接口。 - 避免在代码中硬编码敏感信息，如endpoint、namespace、AK和SK。可以使用ACM的配置文件或系统变量来管理这些信息。 - 对于动态配置，需要处理配置变更的回调逻辑，这可以通过Spring的支持来实现。
通过这样的迁移过程，开发者不仅能够提升应用的配置管理效率，还能够增强应用的弹性和安全性。
最近遇到一些开发者朋友，准备将原有的Java Spring的应用配置迁移到 阿里云应用配置管理 ACM 中。迁移过程中，遇到不少有趣的问题。本文将通过一个简单的样例来还原迁移过程中遇到的问题和相关解决思路，以期达到和读者交流的目的。
什么样的配置适合进入配置中心
这是所有准备迁移配置到配置中心的用户遇到的第一个问题。我们将从时效性和安全这两个维度进行分析。
时效性：静态 VS 动态
静态配置是指程序版本一旦发布，基本上不会修改的配置内容，例如：
软件版本号：显然版本号一经确定，产品基本上不需要改。
日志样式：日志的layout，如时间戳，文件名，日志级别等排版，基本上也不需要大改。
三方软件LicenseKey：基本上也是一经发布，很少变化。不排除中途三方软件License升级，但是这种升级一般都可以根据软件重新发版来解决配置变更。
PaaS平台连接串：如数据库连接串，中间包含数据库，用户名和密码等。除非因为合规原因修改密码，或者数据发生迁移等，否则也是很少变化。
动态配置是指程序运行时的一些配置变化，通常会影响到程序的一些运行行为，例如：
限流降级参数：限流降级参数一般都不太固定。系统一般在运行时最好是需要根据实际workload pattern来动态调节限流参数如阈值RT，峰值TPS，等。
监控报警阈值：如交易环比下跌20%产生error报警，下跌50%产生critical报警。 对于监控系统来讲，线上业务特征由于变化比较频繁，因此一般也不将报警的阈值写死，
日志打印级别：线上一旦出现诡异的行为，希望吧日志打印级别从error比如调高到debug，一般都比较希望能动态的去调整，而不需要重启应用。
容灾多活：一旦站点反生灾难，一定是希望切换是越快越好。因此配置必须动态秒级生效，尽可能降低资损。
从时效性的维度来讲，一般建议用户把静态配置存放到自己文件中，尽可能保持简单，但是需要把动态配置放到配置中心里，以加强灵活性和应用动态变更的实效性。
安全：非敏感 VS 敏感
非敏感配置一般指偏向技术类，暴露后不会导致配置上的安全隐患，例如：
软件版本号：跟产品迭代相关，无业务属性，非敏感配置。
日志样式：一般跟程序事后诊断相关，非敏感配置。
日志打印级别：影响日志打印的多或少，非敏感配置。
限流降级参数：限流降级主要为维持内部应用稳定，非敏感配置。
监控报警阈值：主要是影响业务的报警精度，非敏感配置。
容灾多活：一般和数据主备配置和业务分片相关，非敏感配置。
敏感配置通常和业务数据相关，一旦泄露将引起安全隐患，例如：
三方软件LicenseKey：一旦泄露容易发生LicenseKey被盗用，为敏感配置。
PaaS平台连接串：典型如数据库连接串，一旦泄露，无论内部或外部用户，都可以很容易地登到业务数据库接触到业务敏感信息，为敏感配置。
从安全的维度来看，我们通常建议用户把非敏感配置存放到自己的文件中，尽可能保持简单，但是需要把敏感配置放到配置中心里，并加密且做好鉴权，尽量不要让无关人员接触到。
时效性和安全分析总结
基于 Spring 框架的Java应用配置如何迁移
使用Spring框架的Java开发者一般经常用到的一种配置注解姿势是利用Spring的@value注解。
原始的纯静态文件场景
例如这个配置，包含两个配置参数，一个是软件的版本号，一个是数据库连接串：
通过@PropertySource和@value的注解来自动注入配置。
@Configuration@ComponentScan("com.alibaba")@PropertySource("classpath:myApp.properties") public class AppConfig { @Value(value="${url}") private String URL; @Value(value="${dbuser}") private String USER; @Value(value="${driver}") private String DRIVER; @Value(value="${dbpassword}") private String PASSWORD; @Value(value="${appVersion}") private String version;
}
以上代码省略了相关数据库连接初始化等操作。
开始配置迁移，进入混合配置场景
目前由于安全合规或配置时效等原因，要开始迁移配置到ACM上。经过分析，我们发现部分数据库的配置最好迁移到ACM，以红色字体标注。红色部分将全部被迁移到ACM中。
接下来主要三个改动，先归纳下。
在ACM控制台种增加相关配置的记录。
Java工程包中增加 ACM SDK 相关依赖。
少许修改代码，增加在ACM中取配置的注解代码。
第一步，直接到ACM中创建配置项，名字为myapp.dbconfig.properties，并把配置内容编辑在对应编辑框中。详细操作指南请参见 ACM 快速入门文档，操作截图如下。
第二步，在maven的pom.xml中增加依赖，如下。
com.alibaba.nacos nacos-spring-context 0.2.1- RC1
第三步，在对应AppConfig.java代码中植入API注解，通过ACM去获取动态配置。代码增加部分如红色字体部分。
@Configuration @ComponentScan("com.journaldev")
@PropertySource("classpath:myApp.properties")
@EnableNacosConfig(globalProperties =
@NacosProperties(endpoint = "acm.aliyun.com", namespace = "xxx", accessKey = "xxx", secretKey = "xxx"))
@NacosPropertySource(dataId = "myApp.dbconfig.properties", autoRefreshed = true) public class AppConfig {
@Value(value="${url}") private String URL;
@Value(value="${dbuser}") private String USER;
@Value(value="${driver}") private String DRIVER;
@Value(value="${dbpassword}") private String PASSWORD;
@Value(value="${appVersion}")
private String version; public String getVersion() {
return version;
}
}
至此，改动结束。通过ACM SDK支持Spring的@value注解能力，代码几乎0改动。
几点注意事项
在以上代码实例中，有几样事情需要注意：
代码中使用的ACM SDK为Nacos SDK。Nacos (HTTP://nacos.io) 为ACM的开源实现，ACM无缝兼容所有Nacos的接口。
在代码示例中，使用了明文注解来写死ACM的endpoint, namespace, AK, SK, 等等。在实际操作种，相关变量其实不用写死。
代码中未包含动态配置监听的回调部分。基于Spring的动态配置相关使用方法请参见：https://github.com/nacos-group/nacos-spring-project
