Thorntail迁移评估中如何外部化配置运行Wildfly bootable jar

核心能力说明 #

完全可以将HTTP端口、JDBC驱动这类服务器与应用配置放置在外部YAML文件中，启动Bootable Jar时指定文件路径动态加载配置，实现和Thorntail -s 参数等价的配置外置效果，不需要将生产环境配置打包进Jar包内。

可落地的实现方式 #

1. 基于SmallRye Config的YAML原生加载（最贴近日常使用习惯） #

这是和Thorntail配置体验最接近的实现路径，不需要编写额外业务代码：

• 构建阶段在Bootable Jar的依赖中引入SmallRye Config的YAML解析扩展，该组件是Wildfly官方MicroProfile Config规范的实现，原生支持读取YAML格式的配置源
• 启动时通过JVM参数指定外部YAML文件的绝对/相对路径即可完成加载，对应命令：
  java -jar your-app-bootable.jar -Dmp.config.location=file:./application_config.yml
• 该方式加载的外部YAML属性拥有高于Jar包内置默认配置的优先级，不管是HTTP监听端口、JDBC驱动类名、数据源连接参数，都可以通过YML键值对直接定义，运行时会自动注入到Wildfly的服务器配置上下文中

2. 基于外部属性加载的CLI等价能力（完全对标Thorntail的CLI片段加载逻辑） #

Thorntail 原有的 -s 参数本质是在启动阶段加载外部配置片段覆盖默认值，Wildfly Bootable Jar 原生支持启动时加载外部属性文件：

• 可以直接将配置项写入.properties格式的外部文件，启动时通过参数指定文件路径加载：java -jar your-app-bootable.jar --properties=./application_config.properties
• 如果坚持使用YAML格式存储配置，只需要在应用的启动扩展中加入极简的YAML解析逻辑，将YML内的键值对转换为Wildfly可识别的系统属性即可，Wildfly运行时会优先读取系统属性值，覆盖Jar内打包的默认配置

常用外置配置的映射规则 #

• HTTP端口：在外部配置中直接定义jboss.http.port=自定义端口值，启动时会自动覆盖内置的默认HTTP监听端口
• JDBC驱动与数据源：外部配置中可定义JDBC驱动类全限定名、驱动包路径、数据源连接URL、认证信息，启动时Wildfly会根据加载到的外部配置自动完成驱动注册与数据源初始化，不需要将敏感配置打包进Jar

与Thorntail启动命令的等价对照 #

Thorntail 原有启动命令：
java -jar application.jar -s application_config.yml

Wildfly Bootable Jar 等价实现命令：
java -jar application.jar -Dmp.config.location=file:./application_config.yml

两种实现的能力完全对齐：均不需要修改Jar包内的文件内容，通过启动命令传入外部配置文件路径，动态覆盖默认服务器配置，实现应用包与环境配置分离的部署目标。

内容的提问来源于stack exchange，提问作者Pedroclemos