Docker新手求教：基于WebSphere Liberty部署Spring Boot的架构最佳实践

Hey there! As someone who's just getting started with Docker, WebSphere Liberty, and Spring Boot WAR deployments, let's walk through the key architecture-level best practices that will help you build robust, maintainable, and efficient containerized applications:

1. 采用多阶段构建（Multi-stage Builds） #

这是减小镜像体积、隔离构建环境的核心技巧：

• 第一阶段用Maven/Gradle镜像完成Spring Boot项目的编译、打包，生成WAR文件，不需要把构建工具和海量依赖留在最终镜像里。
• 第二阶段基于官方websphere-liberty镜像，只复制第一阶段生成的WAR包，保证最终镜像只包含运行必需的组件。

示例Dockerfile：

# 构建阶段：生成WAR包
FROM maven:3.8.6-openjdk-11 AS builder
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline  # 提前下载依赖，加速后续构建
COPY src ./src
RUN mvn package -DskipTests

# 运行阶段：部署到WebSphere Liberty
FROM websphere-liberty:latest
COPY --from=builder /app/target/your-spring-app.war /config/dropins/

2. 彻底分离配置与应用代码 #

不要把配置文件（比如WebSphere的server.xml、Spring的application.properties）打包进WAR或镜像，遵循12-Factor应用原则：

• 通过Docker挂载卷加载自定义配置：比如把宿主机的config目录挂载到容器的/config路径，随时修改配置无需重构镜像。
• 通过环境变量注入Spring Boot配置参数，适配不同环境：

ENV SPRING_PROFILES_ACTIVE=production
ENV SPRING_DATASOURCE_URL=jdbc:mysql://db-container:3306/mydb

3. 坚持单一职责原则 #

每个镜像只运行一个服务：你的Spring Boot应用（由WebSphere Liberty托管）。

• 数据库、缓存、消息队列等其他组件，都用独立的Docker容器部署，通过Docker网络实现容器间通信。
• 这样做的好处是：可以独立缩放每个服务、单独更新组件、排查问题更精准，架构逻辑更清晰。

4. 精简WebSphere Liberty配置 #

不要使用默认的全量特性配置，只启用你需要的功能，减少资源占用和攻击面：

• 定制server.xml，仅添加Spring Boot运行必需的特性（比如springBoot-2.0、servlet-4.0），然后在构建时复制到镜像：

COPY ./custom-server.xml /config/server.xml

5. 规范镜像版本与标签管理 #

给你的镜像打上清晰、可追踪的标签，避免用latest标签部署生产环境：

• 可以用Git commit哈希、应用版本号、环境标识来打标签：

docker build -t your-company/spring-liberty-app:1.0.0 .
docker build -t your-company/spring-liberty-app:prod-20240520 .

• 这样便于版本回滚、环境区分，部署流程更可控。

6. 添加健康检查与监控 #

确保Docker能自动识别容器的运行状态，异常时自动恢复：

• 在Dockerfile中添加HEALTHCHECK指令，检查Spring Boot Actuator的健康端点（需提前开启Actuator）：

HEALTHCHECK --interval=30s --timeout=10s \
  CMD curl -f http://localhost:9080/actuator/health || exit 1

7. 优化容器运行权限 #

不要用root用户运行WebSphere Liberty容器，降低安全风险：

• 创建普通用户并切换，同时确保该用户对容器内的运行目录有合适的读写权限：

RUN useradd -m apprunner && chown -R apprunner:apprunner /config /opt/ibm/wlp/usr
USER apprunner

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