arm64v8/open-liberty

Open Liberty Docker 镜像（arm64v8 架构）技术文档

镜像概述和主要用途

概述

arm64v8/open-liberty 是 Open Liberty 官方镜像的 arm64v8 架构专用版本，基于 Ubuntu 操作系统构建，用于在 64 位 ARM 架构环境中运行企业级 Java 应用。Open Liberty 是一款轻量级、模块化的开源 Java 运行时，支持 Java EE 和 MicroProfile 规范，适用于构建和部署微服务及传统企业应用。

主要用途

• 部署 Java EE/MicroProfile 应用
• 构建轻量级微服务架构
• 开发、测试和生产环境的企业级 Java 应用运行时
• 支持 Spring Boot 应用的容器化部署

核心功能和特性

核心功能

• 多 Java 版本支持：提供 Java 8、11、17 运行时环境（基于 OpenJ9 JVM）
• 模块化架构：支持按需加载功能（通过 features.sh 脚本动态扩展）
• 非 root 运行：默认以非特权用户 1001（组 0）运行，增强安全性
• 灵活配置：支持通过配置文件、环境变量和卷挂载自定义服务器行为
• 企业级特性：内置会话缓存、监控等功能，可通过配置启用

关键特性

• 轻量级变体：kernel-slim 标签仅包含核心运行时，可按需扩展功能，减小镜像体积
• 完整功能变体：full 标签包含所有 Open Liberty 功能，开箱即用
• Spring Boot 支持：集成 springBootUtility 工具，支持 Spring Boot 应用的瘦打包和依赖缓存
• 安全强化：默认禁用 root 用户，支持只读文件系统运行模式
• 跨架构兼容：与 amd64、ppc64le、s390x 等架构的 Open Liberty 镜像保持配置一致性

使用场景和适用范围

适用场景

• 开发与测试：快速搭建隔离的 Java 运行环境，支持动态配置更新
• 生产部署：构建包含应用和依赖的不可变镜像，确保部署一致性
• 微服务架构：基于 kernel-slim 构建最小化微服务镜像，降低资源消耗
• Spring Boot 应用：利用 springBootUtility 优化 Spring Boot 应用的容器化部署

适用范围

• 64 位 ARM 架构服务器（如 AWS Graviton、Azure Ampere）
• 需要轻量级 Java 运行时的场景
• 对镜像体积和资源占用敏感的环境
• 遵循 DevOps 实践的 CI/CD 流程

镜像标签说明

标签分类及用途

标签命名规则

标签格式：[版本号-]类型[-java<版本>-openj9]

• 版本号：如 25.0.0.6（可选，默认使用最新稳定版）
• 类型：beta、kernel-slim、full
• Java版本：java8、java11、java17（默认Java 8）
• JVM：固定为 openj9（IBM OpenJ9 JVM）

使用方法和配置说明

基础使用（docker run 命令）

运行默认 full 镜像

bash
docker run -d -p 9080:9080 -p 9443:9443 docker.xuanyuan.run/arm64v8/open-liberty:full

• 映射 HTTP 端口（9080）和 HTTPS 端口（9443）
• 启动默认服务器，包含所有 Open Liberty 功能

挂载本地应用到 dropins 目录

bash
docker run -d -p 9080:9080 \
  -v /本地路径/Sample1.war:/config/dropins/Sample1.war \
  docker.xuanyuan.run/arm64v8/open-liberty:full

• 将本地 WAR 包挂载到容器内 /config/dropins 目录，服务器自动部署

构建自定义镜像（Dockerfile 示例）

基于 kernel-slim 构建最小化应用镜像

dockerfile
# 使用 kernel-slim 作为基础镜像（仅含核心功能）
FROM docker.xuanyuan.run/arm64v8/open-liberty:kernel-slim

# 复制应用配置文件（声明所需功能）
COPY --chown=1001:0 server.xml /config/

# 动态添加 server.xml 中声明的功能（仅 kernel-slim 支持）
RUN features.sh

# 复制应用 WAR 包到 dropins 目录
COPY --chown=1001:0 Sample1.war /config/dropins/

# 优化服务器配置（应用临时修复、预缓存等）
RUN configure.sh

构建并运行：

bash
docker build -t my-openliberty-app .
docker run -d -p 9080:9080 docker.xuanyuan.run/my-openliberty-app

用户与权限配置

默认用户

镜像默认以非 root 用户 1001（组 0）运行。所有 Open Liberty 访问的目录已预设权限，若需扩展其他目录权限，需临时切换至 root 用户：

dockerfile
USER root
RUN mkdir -p /myFolder && chown -R 1001:0 /myFolder  # 授予用户 1001 对 /myFolder 的权限
USER 1001  # 切回非 root 用户

文件权限设置

通过 COPY/ADD 复制文件到容器时，需确保文件对用户 1001 或组 0 有读/执行权限：

• 方法1（推荐）：复制时指定权限

  dockerfile
  COPY --chown=1001:0 server.xml /config/  # 直接设置所有者为 1001:0
  

• 方法2：复制前修改本地文件权限

  bash
  chmod g+rx server.xml  # 确保组有读/执行权限
  

环境变量配置

高级配置

Spring Boot 应用部署

基础部署（完整 JAR 包）

dockerfile
FROM docker.xuanyuan.run/arm64v8/open-liberty:kernel-slim

# 复制 Spring Boot JAR 和配置文件
COPY --chown=1001:0 hellospringboot.jar /config/dropins/spring/
COPY --chown=1001:0 server.xml /config/

# 配置服务器（自动扩展所需功能）
RUN configure.sh

瘦应用部署（分离依赖与应用代码）

利用 springBootUtility 工具分离依赖，优化镜像层：

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

# 阶段2：构建最终镜像
FROM docker.xuanyuan.run/arm64v8/open-liberty:kernel-slim
COPY --chown=1001:0 server.xml /config/
COPY --from=staging /staging/lib.index.cache /lib.index.cache  # 复制依赖缓存
COPY --from=staging /staging/thin.jar /config/dropins/spring/  # 复制瘦应用
RUN configure.sh

自定义密钥库/信任库

默认情况下，镜像会自动生成密钥库。若需使用自定义密钥库，需：

1. 禁用默认生成：ENV KEYSTORE_REQUIRED "false"
2. 将自定义 keystore.xml 复制到 /config/configDropins/defaults/：

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

只读模式运行

需将可写目录挂载为临时文件系统：

bash
docker run -d -p 9080:9080 \
  --read-only \
  --tmpfs /opt/ol/wlp/output \  # 临时存储输出文件
  --tmpfs /logs \               # 临时存储日志
  -v /本地路径/config:/config \ # 挂载配置目录（需包含预生成的密钥库）
  arm64v8/open-liberty:full

镜像变体

kernel-slim vs full

与 WebSphere Liberty 的关系

WebSphere Liberty 是 Open Liberty 的商业发行版，两者镜像兼容，可通过修改 FROM 语句切换：

dockerfile
# 从 Open Liberty 切换到 WebSphere Liberty
FROM docker.xuanyuan.run/websphere-liberty:full-java11-openj9

差异点：

• Open Liberty 安装路径：/opt/ol
• WebSphere Liberty 安装路径：/opt/ibm

部署方案示例

docker-compose 配置示例（生产环境）

yaml
version: '3.8'
services:
  open-liberty:
    image: docker.xuanyuan.run/arm64v8/open-liberty:full-java17-openj9
    ports:
      - "9080:9080"   # HTTP
      - "9443:9443"   # HTTPS
    volumes:
      - ./server.xml:/config/server.xml  # 挂载自定义配置
      - app-data:/config/dropins         # 持久化应用部署目录
      - class-cache:/opt/ol/wlp/output/.classCache  # 共享类缓存
    environment:
      - KEYSTORE_REQUIRED=false  # 使用自定义密钥库
    user: "1001:0"
    restart: unless-stopped

volumes:
  app-data:
  class-cache:

许可证信息

• Open Liberty 软件许可证：https://github.com/OpenLiberty/open-liberty/blob/master/LICENSE
• 镜像包含的其他软件（如 Ubuntu 基础系统组件）可能适用不同许可证，详细信息见 https://github.com/docker-library/repo-info/tree/master/repos/open-liberty%E3%80%82

支持与反馈

• 维护者：https://github.com/OpenLiberty/ci.docker
• 问题反馈：https://github.com/OpenLiberty/ci.docker/issues
• 社区支持：Open Liberty 社区论坛