WebSphere Liberty Docker镜像 (ppc64le架构)

镜像概述和主要用途

WebSphere Liberty是IBM提供的轻量级、模块化的Java应用服务器，专为云环境设计。本镜像基于Ubuntu操作系统，提供针对ppc64le架构优化的WebSphere Liberty运行环境，适用于在Power架构服务器上部署Java EE和微服务应用。

注：这是websphere-liberty镜像的ppc64le架构专用仓库。有关其他架构信息，请参阅镜像文档中的"非amd64架构"部分。

核心功能和特性

• 模块化架构：仅包含应用所需的功能组件，减少资源消耗
• 多Java版本支持：提供Java 8、11和17运行时环境选项
• 企业级功能：内置会话缓存、监控等企业级功能的XML配置片段
• 安全默认配置：包含默认的密钥库和信任库配置
• 非root运行：默认使用非特权用户运行，增强容器安全性
• Spring Boot支持：提供springBootUtility工具优化Spring Boot应用部署

使用场景和适用范围

• 企业Java应用部署：运行Java EE应用程序和微服务
• 云原生应用开发：构建容器化、可扩展的云原生应用
• 微服务架构：作为轻量级应用服务器支持微服务部署
• DevOps流程集成：适合CI/CD管道中的自动化构建和部署
• 跨平台开发：在Power架构环境中提供一致的开发和运行环境

支持的标签和Dockerfile链接

最新版本标签

• 基础内核版

  • kernel, kernel-java8-ibmjava - Dockerfile
  • kernel-java11-openj9 - Dockerfile
  • kernel-java17-openj9 - Dockerfile

• 完整功能版

  • full, latest, full-java8-ibmjava - Dockerfile
  • full-java11-openj9 - Dockerfile
  • full-java17-openj9 - Dockerfile

特定版本标签

• 25.0.0.3版本

  • 25.0.0.3-kernel-java8-ibmjava, 25.0.0.3-kernel-java11-openj9, 25.0.0.3-kernel-java17-openj9
  • 25.0.0.3-full-java8-ibmjava, 25.0.0.3-full-java11-openj9, 25.0.0.3-full-java17-openj9

• 25.0.0.6版本

  • 25.0.0.6-kernel-java8-ibmjava, 25.0.0.6-kernel-java11-openj9, 25.0.0.6-kernel-java17-openj9
  • 25.0.0.6-full-java8-ibmjava, 25.0.0.6-full-java11-openj9, 25.0.0.6-full-java17-openj9

• 25.0.0.9版本

  • 25.0.0.9-kernel-java8-ibmjava, 25.0.0.9-kernel-java11-openj9, 25.0.0.9-kernel-java17-openj9
  • 25.0.0.9-full-java8-ibmjava, 25.0.0.9-full-java11-openj9, 25.0.0.9-full-java17-openj9

详细使用方法和配置说明

镜像用户与权限设置

本镜像默认使用非root用户1001（属于组0）运行。在扩展镜像时，需确保文件和目录权限正确配置。

更新文件夹权限

dockerfile
USER root
RUN mkdir -p /myFolder && chown -R 1001:0 /myFolder
USER 1001

更新文件权限

推荐：使用Docker 17.09+的--chown参数在复制时设置权限

dockerfile
COPY --chown=1001:0 jvm.options /config/jvm.options

兼容旧版Docker：临时切换到root用户修改权限

dockerfile
USER root
RUN chown 1001:0 /config/jvm.options
USER 1001

基本使用方法

1. 构建应用镜像（推荐方式）

使用kernel标签作为基础，构建包含应用的自定义镜像：

dockerfile
FROM ppc64le/websphere-liberty:kernel
COPY --chown=1001:0 Sample1.war /config/dropins/
COPY --chown=1001:0 server.xml /config/
RUN configure.sh

构建并运行：

bash
docker build -t my-liberty-app .
docker run -d -p 9080:9080 my-liberty-app

2. 使用卷挂载进行开发（仅开发环境）

bash
docker run -d -p 80:9080 -p 443:9443 \
    -v /tmp/DefaultServletEngine/dropins/Sample1.war:/config/dropins/Sample1.war \
    ppc64le/websphere-liberty:full

高级配置

启用企业功能

通过Dockerfile中的ARG参数启用企业功能：

dockerfile
ARG ENABLE_SESSION_CACHE=true
ARG ENABLE_MONITORING=true
RUN configure.sh

提供自定义密钥库/信任库

创建自定义keystore.xml文件禁用默认密钥库生成：

xml
<server>
    <!-- 自定义密钥库配置 -->
    <keyStore id="defaultKeyStore" password="yourPassword" type="JKS" location="${server.config.dir}/resources/security/key.jks"/>
</server>

在Dockerfile中添加：

dockerfile
COPY --chown=1001:0 keystore.xml /config/configDropins/defaults/

使用IBM JRE类数据共享

bash
# 创建数据卷容器
docker run -e LICENSE=accept -v /opt/ibm/wlp/output/.classCache --name classcache ppc64le/websphere-liberty true

# 使用数据卷运行应用
docker run -d -p 80:9080 --volumes-from classcache my-liberty-app

以只读模式运行

bash
docker run -d -p 80:9080 -p 443:9443 \
    --tmpfs /opt/ibm/wlp/output --tmpfs /logs -v /config --read-only \
    ppc64le/websphere-liberty:full

更改区域设置

dockerfile
FROM ppc64le/websphere-liberty:full
RUN apt-get update \
  && apt-get install -y language-pack-zh-hans-base \
  && rm -rf /var/lib/apt/lists/*
ENV LANG zh_CN.UTF-8

Spring Boot应用支持

基本Spring Boot应用部署

dockerfile
FROM ppc64le/websphere-liberty:kernel

COPY --chown=1001:0 hellospringboot.jar /config/dropins/spring/
COPY --chown=1001:0 server.xml /config/

RUN configure.sh

构建并运行：

bash
docker build -t spring-liberty-app .
docker run -d -p 9080:9080 spring-liberty-app

使用springBootUtility创建瘦应用

dockerfile
FROM ppc64le/websphere-liberty:kernel as staging
COPY --chown=1001:0 hellospringboot.jar /staging/myFatApp.jar
COPY --chown=1001:0 server.xml /config/
RUN springBootUtility thin \
   --sourceAppPath=/staging/myFatApp.jar \
   --targetThinAppPath=/staging/myThinApp.jar \
   --targetLibCachePath=/staging/lib.index.cache

FROM ppc64le/websphere-liberty:kernel
COPY --chown=1001:0 server.xml /config
COPY --from=staging /staging/lib.index.cache /lib.index.cache
COPY --from=staging /staging/myThinApp.jar /config/dropins/spring/myThinApp.jar
RUN configure.sh

Docker Compose部署示例

yaml
version: '3.8'
services:
  liberty-app:
    build: .
    ports:
      - "9080:9080"
      - "9443:9443"
    volumes:
      - liberty-output:/opt/ibm/wlp/output
    environment:
      - LANG=zh_CN.UTF-8
    restart: unless-stopped

volumes:
  liberty-output:

支持和资源

• 维护者：IBM WASdev社区
• 获取帮助：WASdev社区
• 提交问题：GitHub Issues
• 支持架构：amd64, arm64v8, ppc64le, s390x
• 镜像元数据：repo-info仓库

许可证

Dockerfile和相关脚本采用Apache License 2.0许可。

WebSphere Liberty Docker镜像包含非担保程序国际许可协议(ILAN)，授权WebSphere Liberty客户在国际程序许可协议(IPLA)条款下使用这些镜像。

作为所有Docker镜像，本镜像可能包含其他软件，这些软件可能具有各自的许可条款。镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可。