在Docker中通过环境变量更新配置文件的最优方案

核心逻辑是把配置替换操作从镜像构建阶段迁移到容器启动阶段，后续仅修改环境变量配置、重启容器即可生效，无需重新构建镜像。

1. 调整server.xml #

在server.xml中对应位置预留占位符即可，示例：

<!-- 其他固定的server.xml配置 -->
$CONNECTOR_CONFIG
<!-- 剩余固定配置 -->

2. 调整Dockerfile（仅首次修改一次，后续无需更新） #

不需要在构建阶段执行sed替换，保留原有的文件拷贝逻辑即可：

FROM tomcat:9
# 拷贝配置和应用包到镜像内
COPY server.xml /usr/local/tomcat/conf/server.xml
COPY ./*.war /usr/local/tomcat/webapps/

3. 修改docker-compose.yml配置 #

新增环境变量文件引入，重写容器启动命令，在启动tomcat前先执行占位符替换：

version: '3'
services:
  tomcat:
    build: ./tomcat
    # 引入你的环境变量文件
    env_file:
      - ./variables.env
    # 启动时先替换配置占位符，再启动tomcat
    command: >
      sh -c "sed -i 's#\$CONNECTOR_CONFIG#$CONNECTOR_CONFIG#g' /usr/local/tomcat/conf/server.xml && catalina.sh run"
    ports:
      - "8080:8080"

注：sed命令使用#作为分隔符是为了避免配置中存在/字符导致的转义错误。

4. 编写variables.env文件 #

按照实际需求填写配置值即可，支持多行配置：

CONNECTOR_CONFIG=<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />

后续更新配置操作 #

仅需修改variables.env中的CONNECTOR_CONFIG取值，执行以下命令即可生效，不需要清理或重建镜像：

docker-compose down && docker-compose up -d

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