如何在Dockerfile中外部化application.properties的Keycloak变量

针对你的场景（WildFly运行从Nexus拉取的WAR包，无需修改application.properties即可变更Keycloak配置），以下是两种可行的实现方式，均不依赖docker-compose：

方法1：构建时替换application.properties（固定配置镜像） #

这种方式会在构建Docker镜像时直接替换WAR包内的application.properties配置，适合配置相对固定的场景，每个配置组合对应一个镜像。

步骤： #

1. 调整application.properties的占位格式：将Keycloak相关配置设为可被替换的行（无需特意写占位符，用正则匹配覆盖原有值即可）：

   # application.properties 示例
   keycloak.auth-server-url=http://default-keycloak/auth
   keycloak.realm=default-realm
   keycloak.resource=default-client
   keycloak.credentials.secret=default-secret
   # 其他配置...
   

2. 编写Dockerfile：通过ARG定义构建参数，拉取WAR包后解压替换配置，再重新打包：

   FROM quay.io/wildfly/wildfly:27.0.1.Final-jdk17
   
   # 定义Keycloak构建参数，构建时用--build-arg传递
   ARG KEYCLOAK_AUTH_URL=http://default-keycloak:8080/auth
   ARG KEYCLOAK_REALM=default-realm
   ARG KEYCLOAK_CLIENT_ID=default-client
   ARG KEYCLOAK_CLIENT_SECRET=default-secret
   
   # 从Nexus拉取WAR包（需提前配置Nexus访问凭证）
   RUN curl -u nexus-username:nexus-password https://your-nexus-domain/repository/wars/your-app-latest.war -o /opt/jboss/wildfly/standalone/deployments/your-app.war
   
   # 解压WAR、替换配置、重新打包
   RUN unzip /opt/jboss/wildfly/standalone/deployments/your-app.war -d /tmp/app-temp && \
       # 用sed正则匹配替换每行配置，覆盖原有值
       sed -i "s|keycloak.auth-server-url=.*|keycloak.auth-server-url=${KEYCLOAK_AUTH_URL}|" /tmp/app-temp/BOOT-INF/classes/application.properties && \
       sed -i "s|keycloak.realm=.*|keycloak.realm=${KEYCLOAK_REALM}|" /tmp/app-temp/BOOT-INF/classes/application.properties && \
       sed -i "s|keycloak.resource=.*|keycloak.resource=${KEYCLOAK_CLIENT_ID}|" /tmp/app-temp/BOOT-INF/classes/application.properties && \
       sed -i "s|keycloak.credentials.secret=.*|keycloak.credentials.secret=${KEYCLOAK_CLIENT_SECRET}|" /tmp/app-temp/BOOT-INF/classes/application.properties && \
       # 重新打包WAR
       cd /tmp/app-temp && zip -r /opt/jboss/wildfly/standalone/deployments/your-app.war . && \
       # 清理临时文件
       rm -rf /tmp/app-temp
   
   # 启动WildFly
   CMD ["/opt/jboss/wildfly/bin/standalone.sh", "-b", "0.0.0.0"]
   

3. 构建镜像：

   docker build --build-arg KEYCLOAK_AUTH_URL=http://your-keycloak:8080/auth \
                --build-arg KEYCLOAK_REALM=your-realm \
                --build-arg KEYCLOAK_CLIENT_ID=your-client \
                --build-arg KEYCLOAK_CLIENT_SECRET=your-secret \
                -t your-app:v1 .
   

方法2：运行时通过环境变量覆盖（灵活配置容器） #

这种方式无需修改WAR包，通过JVM系统属性传递配置，Spring Boot会自动读取这些属性覆盖application.properties的值，同一个镜像可以运行不同配置的容器，灵活性更高。

步骤： #

1. 修改application.properties支持系统属性覆盖：使用${变量名:默认值}格式，允许通过JVM参数或环境变量覆盖：

   # application.properties 示例
   keycloak.auth-server-url=${keycloak.auth-server-url:http://default-keycloak/auth}
   keycloak.realm=${keycloak.realm:default-realm}
   keycloak.resource=${keycloak.resource:default-client}
   keycloak.credentials.secret=${keycloak.credentials.secret:default-secret}
   # 其他配置...
   

2. 编写Dockerfile：定义ENV默认值，创建启动脚本传递JVM参数：

   FROM quay.io/wildfly/wildfly:27.0.1.Final-jdk17
   
   # 定义Keycloak环境变量，运行时用-e覆盖
   ENV KEYCLOAK_AUTH_URL=http://default-keycloak:8080/auth
   ENV KEYCLOAK_REALM=default-realm
   ENV KEYCLOAK_CLIENT_ID=default-client
   ENV KEYCLOAK_CLIENT_SECRET=default-secret
   
   # 从Nexus拉取WAR包
   RUN curl -u nexus-username:nexus-password https://your-nexus-domain/repository/wars/your-app-latest.war -o /opt/jboss/wildfly/standalone/deployments/your-app.war
   
   # 创建启动脚本，传递JVM系统属性
   RUN echo '#!/bin/bash' > /opt/jboss/wildfly/bin/start-app.sh && \
       echo '/opt/jboss/wildfly/bin/standalone.sh -b 0.0.0.0 \' >> /opt/jboss/wildfly/bin/start-app.sh && \
       echo "-Dkeycloak.auth-server-url=${KEYCLOAK_AUTH_URL} \\" >> /opt/jboss/wildfly/bin/start-app.sh && \
       echo "-Dkeycloak.realm=${KEYCLOAK_REALM} \\" >> /opt/jboss/wildfly/bin/start-app.sh && \
       echo "-Dkeycloak.resource=${KEYCLOAK_CLIENT_ID} \\" >> /opt/jboss/wildfly/bin/start-app.sh && \
       echo "-Dkeycloak.credentials.secret=${KEYCLOAK_CLIENT_SECRET}" >> /opt/jboss/wildfly/bin/start-app.sh && \
       chmod +x /opt/jboss/wildfly/bin/start-app.sh
   
   # 执行启动脚本
   CMD ["/opt/jboss/wildfly/bin/start-app.sh"]
   

3. 运行容器：直接用-e参数覆盖环境变量即可：

   docker run -d -p 8080:8080 \
              -e KEYCLOAK_AUTH_URL=http://your-keycloak:8080/auth \
              -e KEYCLOAK_REALM=your-realm \
              -e KEYCLOAK_CLIENT_ID=your-client \
              -e KEYCLOAK_CLIENT_SECRET=your-secret \
              your-app:latest
   

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