本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

amd64/open-liberty

基于Ubuntu的Open Liberty多架构镜像，用于运行Java应用并支持多种硬件架构。

0 次下载activeamd64镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

Open Liberty Docker 镜像文档

镜像概述

概述

amd64/open-liberty 镜像是 open-liberty 官方镜像的 amd64 架构专用仓库。所有镜像均基于 Ubuntu 操作系统构建，若需使用基于 Universal Base Image 的变体，请参考 openliberty/open-liberty 仓库。

主要用途

提供轻量级、可定制的 Open Liberty 运行时环境，用于在容器中部署和运行 Java EE 及 MicroProfile 应用程序，支持快速开发、测试和生产部署。

维护与支持

维护者：Open Liberty 社区
获取帮助：Open Liberty 社区

核心功能与特性

多 Java 版本支持：提供 Java 8、11、17 等版本的运行时环境，满足不同应用需求
非 root 用户运行：默认以 USER 1001（非 root）身份运行，增强安全性
灵活的镜像变体：提供 kernel-slim（精简内核）、full（完整功能）、beta（测试版）等多种标签，适配不同场景
功能按需扩展：kernel-slim 镜像支持通过 features.sh 脚本动态下载所需功能特性，减小镜像体积
Spring Boot 支持：内置 springBootUtility 工具，支持 Spring Boot 应用的瘦应用打包和依赖缓存
企业级功能：可通过配置启用会话缓存、监控等企业级功能
兼容性：与 WebSphere Liberty 镜像高度兼容，便于迁移

支持的标签

以下是 amd64/open-liberty 镜像的主要标签及对应的 Dockerfile 链接：

测试版（Beta）

beta
beta-java11
beta-java17

精简内核版（Kernel-slim）

kernel-slim, kernel-slim-java8-openj9
kernel-slim-java11-openj9
kernel-slim-java17-openj9

完整版（Full）

full, full-java8-openj9, latest
full-java11-openj9
full-java17-openj9

特定版本标签

包含 25.0.0.6、25.0.0.9、25.0.0.10 等版本的 kernel-slim 和 full 变体，例如：

25.0.0.10-kernel-slim-java8-openj9
25.0.0.10-full-java17-openj9

使用场景与适用范围

开发与测试环境

快速部署应用原型，通过挂载卷实现代码热更新
验证应用在不同 Java 版本和 Liberty 特性组合下的兼容性

生产环境

构建包含应用及依赖的完整镜像，确保部署一致性
运行微服务架构应用，利用 kernel-slim 镜像减小资源占用

企业级应用

需要会话缓存、监控等企业功能的业务系统
基于 Spring Boot 框架开发的微服务应用

详细使用方法与配置说明

镜像用户与权限配置

默认用户

镜像默认以 USER 1001（非 root 用户）运行，所属用户组为 0。所有 Open Liberty 访问的目录已配置适当权限，扩展镜像时需确保新增文件/目录的权限正确。

目录权限更新

如需为扩展 Dockerfile 中的其他目录配置权限，可临时切换至 root 用户：

USER root
RUN mkdir -p /myFolder && chown -R 1001:0 /myFolder  # 授予用户 1001 和组 0 权限
USER 1001

文件权限更新

通过 COPY 或 ADD 复制到镜像的文件默认所有权为 root:0，需确保用户 1001 或组 0 具有读/执行权限，推荐以下方法：

复制前更新权限：设置文件的组权限为可读/执行

chmod g+rx server.xml  # 确保组 0 可读写 server.xml

复制时指定权限（Docker 17.09+）：使用 --chown 参数

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

复制后更新权限（不推荐，可能增加镜像层数）：

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

应用部署方法

推荐：构建应用镜像（Application Image）

将应用及配置打包到镜像中，确保部署一致性，示例 Dockerfile：

FROM amd64/open-liberty:kernel-slim  # 使用精简内核镜像

# 添加服务器配置
COPY --chown=1001:0 server.xml /config/
# 下载 server.xml 中声明的特性（仅 kernel-slim 支持）
RUN features.sh

# 添加应用
COPY --chown=1001:0 Sample1.war /config/dropins/
# 应用配置、应用临时修复并优化运行时缓存
RUN configure.sh

构建并运行：

docker build -t my-app .
docker run -d -p 9080:9080 my-app  # 映射容器 9080 端口到主机

开发场景：使用卷挂载配置

适合快速迭代，直接挂载主机文件到容器：

# 挂载 WAR 包到 dropins 目录
docker run -d -p 80:9080 -p 443:9443 \
  -v /tmp/DefaultServletEngine/dropins/Sample1.war:/config/dropins/Sample1.war \
  amd64/open-liberty:full

挂载完整配置目录：

docker run -d -p 80:9080 \
  -v /tmp/DefaultServletEngine:/config \  # 挂载主机配置目录到容器 /config
  amd64/open-liberty:full

Spring Boot 应用支持

部署 Spring Boot 胖 JAR

创建 server.xml 并启用 springBoot-2.0 特性：

<server>
  <featureManager>
    <feature>springBoot-2.0</feature>
  </featureManager>
  <httpEndpoint host="*" httpPort="9080" httpsPort="-1"/>
</server>

构建应用镜像：

FROM amd64/open-liberty:kernel-slim
COPY --chown=1001:0 hellospringboot.jar /config/dropins/spring/  # Spring Boot 应用需放入 dropins/spring 目录
COPY --chown=1001:0 server.xml /config/
RUN configure.sh

运行：

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

使用 thin 应用与依赖缓存（推荐）

利用 springBootUtility 将胖 JAR 拆分为 thin 应用和依赖缓存，优化镜像层数：

# 阶段 1：生成 thin 应用和依赖缓存
FROM amd64/open-liberty:kernel-slim as staging
COPY --chown=1001:0 hellospringboot.jar /staging/
RUN springBootUtility thin \
  --sourceAppPath=/staging/hellospringboot.jar \
  --targetThinAppPath=/staging/thin-app.jar \
  --targetLibCachePath=/staging/lib.index.cache

# 阶段 2：构建最终镜像
FROM amd64/open-liberty:kernel-slim
COPY --chown=1001:0 server.xml /config/
COPY --from=staging --chown=1001:0 /staging/lib.index.cache /lib.index.cache  # 依赖缓存层
COPY --from=staging --chown=1001:0 /staging/thin-app.jar /config/dropins/spring/
RUN configure.sh

密钥库/信任库配置

默认情况下，镜像启动时会在 /config/configDropins/defaults/keystore.xml 生成自签名证书的密钥库配置，通过以下环境变量控制：

启用默认密钥库（默认）：

ENV KEYSTORE_REQUIRED "true"

禁用默认密钥库（使用自定义密钥库时）：

ENV KEYSTORE_REQUIRED "false"

自定义密钥库推荐放置于 /config/configDropins/defaults/keystore.xml。

企业功能启用

通过 ARG 变量在 Dockerfile 中启用企业功能（如会话缓存、监控），并通过 configure.sh 应用配置，详情参考官方文档。

IBM JRE 类数据共享（Class Data Sharing）

IBM JRE 支持通过共享内存文件 /opt/ol/wlp/output/.classCache 实现类数据共享，提升多容器启动速度，配置方法：

挂载主机目录：

docker run -d -p 9080:9080 \
  -v /host/path/to/classCache:/opt/ol/wlp/output/.classCache \
  my-app

使用数据卷容器：

# 创建数据卷容器
docker run -v /opt/ol/wlp/output/.classCache --name classcache amd64/open-liberty true
# 挂载数据卷
docker run -d -p 9080:9080 --volumes-from classcache my-app

只读模式运行

Liberty 运行时需写入 /opt/ol/wlp/output 和 /logs 目录，只读模式下需将其挂载为临时文件系统：

docker run -d -p 9080:9080 \
  --read-only \
  --tmpfs /opt/ol/wlp/output \  # 临时文件系统用于输出
  --tmpfs /logs \  # 临时文件系统用于日志
  -v /host/config:/config \  # 挂载配置目录（需可写，或预构建密钥库）
  amd64/open-liberty:full

Docker 部署方案示例

基础运行命令

# 启动完整版镜像，映射 HTTP(9080) 和 HTTPS(9443) 端口
docker run -d -p 9080:9080 -p 9443:9443 amd64/open-liberty:full

部署 Spring Boot 应用

# 构建镜像
docker build -t spring-boot-app -f Dockerfile.spring .
# 运行容器，映射 8080 端口
docker run -d -p 8080:9080 --name my-spring-app spring-boot-app

docker-compose 示例

version: '3'
services:
  liberty-app:
    image: amd64/open-liberty:kernel-slim-java17-openj9
    build: .  # 基于当前目录 Dockerfile 构建
    ports:
      - "9080:9080"
    volumes:
      - ./config:/config  # 挂载配置目录（开发环境）
    environment:
      - KEYSTORE_REQUIRED=false  # 使用自定义密钥库
    user: "1001:0"