open-liberty Docker 镜像 - 轩辕镜像

Open Liberty Docker镜像文档

概述

Open Liberty是一个轻量级、模块化的Java应用服务器，专为云原生环境设计。本仓库提供基于Ubuntu操作系统的多架构Docker镜像，支持多种Java版本和功能组合，适用于开发、测试和生产环境。

快速参考

• 维护者：Open Liberty社区
• 获取帮助：Open Liberty社区
• 提交问题：GitHub Issues
• 支持的架构：amd64、arm64v8、ppc64le、s390x
• 镜像元数据：repo-info仓库
• 镜像更新：official-images仓库

支持的标签

以下是主要标签及其对应的Dockerfile链接：

• 测试版：beta、beta-java11、beta-java17
• 精简内核版：kernel-slim、kernel-slim-java8-openj9、kernel-slim-java11-openj9、kernel-slim-java17-openj9
• 完整版：full、full-java8-openj9、latest、full-java11-openj9、full-java17-openj9
• 特定版本：如25.0.0.3-kernel-slim-java8-openj9、25.0.0.6-full-java17-openj9等

完整标签列表及Dockerfile链接请参见官方仓库。

镜像用户指南

默认用户

镜像默认使用非root用户1001运行，属于组0。所有Open Liberty访问的文件夹已配置适当权限。

权限设置

文件夹权限更新

如需添加新文件夹并设置权限，可临时切换至root用户：

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

文件权限设置

通过COPY或ADD复制到镜像的文件需确保用户1001或组0有读和执行权限，推荐方法：

• Docker 17.09+：使用--chown参数

  dockerfile
  COPY --chown=1001:0 server.xml /config/server.xml
  

• 早期版本：复制后修改权限

  dockerfile
  USER root
  RUN chown 1001:0 /config/server.xml
  USER 1001
  

部署方案示例

基础部署

bash
docker run -d -p 9080:9080 -p 9443:9443 --name open-liberty open-liberty:full

自定义应用部署

创建Dockerfile：

dockerfile
FROM open-liberty:kernel-slim

# 添加服务器配置
COPY --chown=1001:0 server.xml /config/
# 下载所需功能
RUN features.sh

# 添加应用
COPY --chown=1001:0 Sample1.war /config/dropins/
# 配置服务器
RUN configure.sh

构建并运行：

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

使用数据卷持久化配置

bash
docker run -d -p 9080:9080 -v /path/to/config:/config open-liberty:full

使用方法

应用镜像模式

推荐创建包含应用和配置的自定义镜像，确保环境一致性和可移植性。基础Dockerfile结构：

dockerfile
FROM open-liberty:kernel-slim
COPY --chown=1001:0 server.xml /config/
RUN features.sh
COPY --chown=1001:0 app.war /config/dropins/
RUN configure.sh

开发模式（使用卷挂载）

适合开发阶段快速迭代：

bash
docker run -d -p 9080:9080 -v /local/path/to/app.war:/config/dropins/app.war open-liberty:full

Spring Boot应用部署

1. 基本部署：

dockerfile
FROM open-liberty:kernel
COPY --chown=1001:0 hellospringboot.jar /config/dropins/spring/
COPY --chown=1001:0 server.xml /config/
RUN configure.sh

2. 优化部署（分离依赖和应用）：

dockerfile
FROM open-liberty:kernel as staging
COPY --chown=1001:0 hellospringboot.jar /staging/app.jar
RUN springBootUtility thin --sourceAppPath=/staging/app.jar --targetThinAppPath=/staging/thin-app.jar --targetLibCachePath=/staging/lib.index.cache

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

高级配置

自定义密钥库/信任库

默认情况下，镜像会生成自签名证书。如需使用自定义密钥库：

dockerfile
ENV KEYSTORE_REQUIRED "false"
COPY --chown=1001:0 keystore.xml /config/configDropins/defaults/

类数据共享

提高多个容器的启动性能：

bash
docker run -d -v /host/path/classCache:/opt/ol/wlp/output/.classCache my-liberty-app

只读模式运行

bash
docker run -d -p 9080:9080 -p 9443:9443 \
  --tmpfs /opt/ol/wlp/output --tmpfs /logs -v /config --read-only \
  open-liberty:full

镜像变体

• 完整版 (full)：包含所有运行时功能，适合快速启动和评估
• 精简内核版 (kernel-slim)：仅包含Liberty内核，需手动添加所需功能，适合构建最小化生产镜像
• 测试版 (beta)：包含最新功能，适合测试但不推荐生产环境使用

与WebSphere Liberty的关系

WebSphere Liberty是Open Liberty的商业发行版，两者Docker镜像基本兼容，可通过修改FROM指令切换。主要差异：

• Open Liberty安装路径为/opt/ol，而非/opt/ibm
• 使用/config文件夹存放服务器配置
• 使用/output文件夹存放输出文件

许可证

查看许可证信息了解镜像中包含的软件许可条款。使用本镜像即表示您同意所有包含软件的许可条款。