bellsoft/liberica-openjre-debian 镜像文档

1. 镜像概述

1.1 关于 Liberica JDK

Liberica JDK 是由 BellSoft 开发并支持的免费、100% 开源的渐进式 Java 运行时，适用于现代 Java 部署场景。BellSoft 作为 OpenJDK 的主要贡献者，确保 Liberica JDK 符合 Java SE 规范并提供持续支持。Spring ***推荐并使用 Liberica JDK 作为 Spring Native 应用的端到端解决方案。

1.2 镜像主要用途

本镜像基于 Debian 系统构建，包含 Liberica JRE（Java Runtime Environment），旨在为 Java 应用提供轻量、可靠的运行环境。适用于需要在容器化环境中部署 Java 应用的场景，支持多架构部署。

2. 核心功能与特性

2.1 跨平台灵活性

支持当前主流的硬件架构和操作系统，包括 x86_64、aarch64、armhf 等，可作为桌面、服务器、云环境及嵌入式设备的统一 Java 运行时。

2.2 成本与时间效率

基于 Liberica Lite 和 Alpine Linux 构建的容器体积极小，有助于减少部署时间和云资源成本，提升应用交付效率。

2.3 安全性与可靠性

通过 Java SE 规范的 TCK 认证，确保兼容性
每版本发布前均经过全面安全测试
遵循 CPU（关键补丁更新）发布周期，及时提供安全补丁和 bug 修复，保障运行时的安全性和性能稳定性

3. 适用场景与架构支持

3.1 适用场景

企业级 Java 应用部署（微服务、后端服务等）
云原生环境（Kubernetes、Docker Swarm 等）
嵌入式设备（如 Raspberry Pi 2/3）
开发与测试环境的 Java 运行时依赖

3.2 支持架构

x86_64（amd64）
aarch64（ARM64）
armhf（适用于 Raspberry Pi 2/3 等设备）

4. 镜像内容与标签说明

4.1 标签结构

镜像标签遵循以下命名规则：
X-Y

X：Java 版本号（如 8u462、11、21.0.8）
Y：架构类型（如 x86_64、aarch64、armhf）。若标签中不含架构信息，则默认支持 amd64 和 arm64 架构。

特殊标签说明：

-cds：标签中包含 -cds 表示镜像内置 CDS（Class Data Sharing，类数据共享）归档，可加速 Java 应用启动。
latest：指向最新版本的镜像。

4.2 标签列表

以下为主要可用标签（完整列表请参考 Docker Hub）：

Java 25：latest, latest-cds, 25, 25-cds
Java 24：24, 24-cds
Java 23：23, 23-cds
Java 22：22, 22-cds
Java 21：21.0.8, 21.0.8-cds, 21.0.7, 21.0.7-cds, 21.0.6, 21.0.6-cds, 21.0.5, 21.0.5-cds, 21.0.4, 21.0.4-cds, 21.0.3, 21.0.3-cds, 21, 21-cds
Java 20：20
Java 19：19
Java 18：18
Java 17：17.0.16, 17.0.16-cds, 17.0.15, 17.0.15-cds, 17.0.14, 17.0.14-cds, 17.0.13, 17.0.13-cds, 17.0.12, 17.0.12-cds, 17.0.11, 17.0.11-cds, 17, 17-cds
Java 16：16
Java 15：15
Java 11：11.0.28, 11.0.28-cds, 11.0.27, 11.0.27-cds, 11.0.26, 11.0.26-cds, 11.0.25, 11.0.25-cds, 11.0.24, 11.0.24-cds, 11.0.23, 11.0.23-cds, 11, 11-cds
Java 10：10
Java 9：9（仅支持 armhf 架构）
Java 8：8u462, 8u462-cds, 8u452, 8u452-cds, 8u442, 8u442-cds, 8u432, 8u432-cds, 8u422, 8u422-cds, 8u412, 8u412-cds, 8, 8-cds（仅支持 amd64 和 aarch64 架构）

5. 使用方法

5.1 基本使用（`docker run`）

检查 Java 版本

运行以下命令启动容器并验证 Java 版本：

bash
docker run -it --rm bellsoft/liberica-openjre-debian:latest java -version

运行 Java 应用

通过挂载卷运行本地 JAR 应用：

bash
docker run -it --rm -v /path/to/local/app:/app bellsoft/liberica-openjre-debian:17 java -jar /app/MyApplication.jar

5.2 构建应用镜像（Dockerfile 示例）

基于本镜像构建自定义应用镜像，创建 Dockerfile：

dockerfile
# 指定基础镜像（例如 Java 17 版本）
FROM bellsoft/liberica-openjre-debian:17

# 设置工作目录
WORKDIR /app

# 复制应用 JAR 文件到容器
COPY target/MyApplication.jar app.jar

# 启动命令
ENTRYPOINT ["java", "-jar", "app.jar"]

构建并运行：

bash
docker build -t my-java-app .
docker run -it --rm my-java-app

5.3 Docker Compose 配置示例

创建 docker-compose.yml：

yaml
version: '3.8'
services:
  java-app:
    image: bellsoft/liberica-openjre-debian:17-cds  # 使用带 CDS 的镜像加速启动
    container_name: my-java-service
    volumes:
      - ./app:/app  # 挂载应用目录
    ports:
      - "8080:8080"  # 映射端口
    command: ["java", "-jar", "/app/MyApplication.jar"]
    restart: unless-stopped

启动服务：