如何在OpenShift/Docker中为JBoss可执行Jar配置环境变量？

核心问题分析 #

你之前的Dockerfile失败的关键原因是：每个RUN指令都是独立的Shell会话，export contentpath定义的变量无法在后续RUN中复用。另外，构建时修改Jar包的方式不够灵活，无法适配运行时动态传入的环境变量。

以下是几种更优的处理方案，按推荐优先级排序：

方案1：利用WildFly/JBoss原生配置注入（最推荐） #

JBoss/WildFly Bootable Jar支持通过系统属性或环境变量表达式直接覆盖配置，无需解压修改Jar包。

步骤：

1. 修改bc4j.xcfg中的占位符为EL表达式，直接引用环境变量：

<!-- 示例配置，根据你的实际结构调整 -->
<connection-definition>
  <property name="host" value="${env.DB_HOST:localhost}"/>
  <property name="username" value="${env.DB_USER:myappuser}"/>
  <property name="password" value="${env.DB_PASS:myapppassword}"/>
  <property name="sid" value="${env.DB_SID:myappsid}"/>
</connection-definition>

2. 简化Dockerfile，直接启动Jar，无需任何打包操作：

FROM registry.redhat.io/ubi8/openjdk-17-runtime

USER 185

ADD myapp-0.0.1-SNAPSHOT-bootable.jar .

# 定义默认环境变量（可选，运行时可覆盖）
ENV DB_HOST=localhost \
    DB_USER=myappuser \
    DB_PASS=myapppassword \
    DB_SID=myappsid

CMD ["java", "-jar", "myapp-0.0.1-SNAPSHOT-bootable.jar"]

3. OpenShift中通过Secret传递凭证：
   创建包含host/username/password/sid的Secret，然后在Deployment中映射为环境变量：

spec:
  template:
    spec:
      containers:
      - name: myapp
        env:
        - name: DB_HOST
          valueFrom:
            secretKeyRef:
              name: db-credentials
              key: host
        - name: DB_USER
          valueFrom:
            secretKeyRef:
              name: db-credentials
              key: username
        - name: DB_PASS
          valueFrom:
            secretKeyRef:
              name: db-credentials
              key: password
        - name: DB_SID
          valueFrom:
            secretKeyRef:
              name: db-credentials
              key: sid

方案2：启动脚本动态修改配置（兼容旧版应用） #

如果无法修改应用配置文件，可通过启动脚本在容器启动时动态解压、修改、重新打包Jar，确保使用运行时的环境变量。

步骤：

1. 创建start.sh脚本（放在项目根目录）：

#!/bin/bash
set -e

# 找到content文件路径
contentpath=$(find . -name "content" | grep -E 'content.+content')
unzip "$contentpath"
contentpath=${contentpath::-7}

# 用环境变量替换配置文件占位符
sed -i "s/envhostname/${DB_HOST:-localhost}/i" "$contentpath/WEB-INF/classes/myapp/common/bc4j.xcfg"
sed -i "s/envusername/${DB_USER:-myappuser}/i" "$contentpath/WEB-INF/classes/myapp/common/bc4j.xcfg"
sed -i "s/envpassword/${DB_PASS:-myapppassword}/i" "$contentpath/WEB-INF/classes/myapp/common/bc4j.xcfg"
sed -i "s/envSID/${DB_SID:-myappsid}/i" "$contentpath/WEB-INF/classes/myapp/common/bc4j.xcfg"

# 重新打包
zip -f -Ar "$contentpath/content" "$contentpath/WEB-INF/classes/myapp/common/bc4j.xcfg"
zip -f wildfly.zip "$contentpath/content"
zip -f myapp-0.0.1-SNAPSHOT-bootable.jar wildfly.zip

# 启动应用
exec java -jar myapp-0.0.1-SNAPSHOT-bootable.jar

2. 修改Dockerfile，添加脚本并设置执行权限：

FROM registry.redhat.io/ubi8/openjdk-17-runtime

USER root

RUN microdnf install fontconfig zip-3.0-23.el8.x86_64 && \
    microdnf clean all

USER 185

ADD myapp-0.0.1-SNAPSHOT-bootable.jar .
ADD start.sh .
RUN chmod +x start.sh

ENV DB_HOST=localhost \
    DB_USER=myappuser \
    DB_PASS=myapppassword \
    DB_SID=myappsid

CMD ["./start.sh"]

方案3：挂载外部配置文件（适合需频繁修改的场景） #

如果bc4j.xcfg可以从外部路径加载，可将配置文件挂载到容器中，替代Jar内的文件：

1. 修改应用代码，优先读取外部路径（如/config/bc4j.xcfg）的配置
2. Docker中通过-v挂载本地配置文件，OpenShift中通过ConfigMap/Secret挂载到/config目录

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