如何在Docker中创建含指定名称服务器的Liberty镜像而非defaultServer

Liberty官方镜像默认使用defaultServer作为实例名称，但可以通过Dockerfile的简单步骤构建含指定名称服务器的镜像，完全不用改动现有server.xml或进入容器重命名实例。

核心思路 #

通过Liberty的server create <server-name>命令直接创建指定名称的服务器实例，再将你的应用配置和程序复制到该实例的目录下，最后指定启动这个自定义实例即可。

Dockerfile示例 #

# 基于官方Liberty镜像（可根据需求选择对应tag）
FROM icr.io/appcafe/open-liberty:full-java17-openj9

# 构建时可传入自定义服务器名称，默认设为myCustomServer
ARG SERVER_NAME=myCustomServer

# 创建指定名称的Liberty服务器实例
RUN server create ${SERVER_NAME}

# 复制你的server.xml到自定义服务器的配置目录
COPY ./server.xml /opt/ol/wlp/usr/servers/${SERVER_NAME}/server.xml

# 复制你的应用包到自定义服务器的部署目录（按需添加）
COPY ./my-app.war /opt/ol/wlp/usr/servers/${SERVER_NAME}/apps/

# 启动自定义服务器（--clean确保每次启动清理缓存，--background让容器保持运行）
CMD ["server", "start", "${SERVER_NAME}", "--clean", "--background"]

步骤说明 #

• ARG参数：允许你在构建镜像时灵活指定服务器名称，比如执行docker build --build-arg SERVER_NAME=myAppServer .就能生成名为myAppServer的服务器实例镜像。
• server create命令：自动生成指定名称服务器的完整目录结构，包括基础配置文件（如jvm.options、bootstrap.properties），省去手动创建目录的麻烦。
• 复制配置与应用：将你本地已配置好服务器名称的server.xml直接复制到自定义服务器的配置目录，启动时Liberty会读取该配置，完全不需要修改原有内容。
• 启动命令：明确指定启动自定义服务器，替代默认的defaultServer。

额外注意 #

如果你的server.xml中已经指定了<server name="xxx">，只要这个名称和你通过SERVER_NAME指定的实例名称一致，就能完美兼容；即使不一致，Liberty也会正常启动实例，只是实例目录名和配置中的服务器名称不同，不影响功能。

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