library/open-liberty

Open Liberty Docker镜像文档

概述

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

快速参考

• 维护者：https://github.com/OpenLiberty/ci.docker
• 获取帮助：Open Liberty社区
• 提交问题：https://github.com/OpenLiberty/ci.docker/issues?q=
• 支持的架构：amd64、arm64v8、ppc64le、s390x
• 镜像元数据：https://github.com/docker-library/repo-info/blob/master/repos/open-liberty
• 镜像更新：https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fopen-liberty

支持的标签

以下是主要标签及其对应的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链接请参见https://github.com/OpenLiberty/ci.docker%E3%80%82

镜像用户指南

默认用户

镜像默认使用非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文件夹存放输出文件

许可证

查看https://github.com/OpenLiberty/open-liberty/blob/master/LICENSE%E4%BA%86%E8%A7%A3%E9%95%9C%E5%83%8F%E4%B8%AD%E5%8C%85%E5%90%AB%E7%9A%84%E8%BD%AF%E4%BB%B6%E8%AE%B8%E5%8F%AF%E6%9D%A1%E6%AC%BE%E3%80%82%E4%BD%BF%E7%94%A8%E6%9C%AC%E9%95%9C%E5%83%8F%E5%8D%B3%E8%A1%A8%E7%A4%BA%E6%82%A8%E5%90%8C%E6%84%8F%E6%89%80%E6%9C%89%E5%8C%85%E5%90%AB%E8%BD%AF%E4%BB%B6%E7%9A%84%E8%AE%B8%E5%8F%AF%E6%9D%A1%E6%AC%BE%E3%80%82