Java Docker 镜像文档

1. 镜像概述和主要用途

本镜像为基于 OpenJDK 17 的 Docker 镜像，构建自 Islandora-DevOps/isle-buildkit java 项目。主要用途是作为所有 Java 服务的基础 Docker 镜像，提供标准化的 Java 17 运行环境，简化 Java 应用的容器化构建流程。

2. 核心功能和特性

• 内置 OpenJDK 17 环境：提供完整的 Java 17 运行时，满足 Java 17 应用的运行需求。
• 基础镜像兼容性：专为作为底层基础镜像设计，确保与各类 Java 服务的构建流程兼容。
• 可靠构建来源：基于 Islandora-DevOps 官方维护的 isle-buildkit 项目构建，保证镜像的稳定性和可维护性。
• 依赖标准化：继承 islandora/base 镜像的系统环境配置，确保底层依赖一致性。

3. 使用场景和适用范围

• 作为构建 Java 17 应用服务的基础镜像（如 Spring Boot 应用、Java Web 服务等）。
• 为需要统一 Java 运行环境的微服务架构提供底层支撑。
• 适用于所有依赖 Java 17 运行时的容器化场景。

4. 使用方法和配置说明

4.1 依赖说明

构建本镜像需依赖 islandora/base 基础镜像。基础镜像的详细信息及配置方法可参考 Base Image README。

4.2 作为基础镜像使用

在自定义 Java 服务的 Dockerfile 中，可直接以本镜像为基础构建：

# 基于本镜像构建自定义 Java 服务
FROM islandora/java:latest

# 复制应用 jar 包到镜像中
COPY ./target/your-app.jar /app/

# 设置工作目录
WORKDIR /app

# 运行应用（可通过命令行参数或环境变量自定义 Java 配置）
CMD ["java", "-jar", "your-app.jar"]

4.3 直接运行示例

如需快速验证 Java 环境，可直接运行镜像并执行 Java 命令：

# 查看 Java 版本
docker run --rm islandora/java:latest java -version

# 运行自定义 Java 命令（示例：执行一段简单 Java 代码）
docker run --rm islandora/java:latest java -e "public class HelloWorld { public static void main(String[] args) { System.out.println(\"Hello, Java 17!\"); }}"

5. 配置参数和环境变量

本镜像默认继承 islandora/base 镜像的环境配置，未添加额外自定义环境变量。如需调整 Java 运行参数（如堆内存、系统属性等），可通过以下方式指定：

5.1 通过命令行参数

直接在运行命令中附加 Java 选项，例如：

docker run --rm islandora/java:latest java -Xmx1g -jar your-app.jar

5.2 通过环境变量

使用 JAVA_OPTS 环境变量统一管理 Java 选项，例如：

docker run --rm -e JAVA_OPTS="-Xmx1g -XX:+UseG1GC" islandora/java:latest java $JAVA_OPTS -jar your-app.jar

详细的 Java 配置参数可参考 Java 官方文档。

6. 依赖信息

构建本镜像需依赖 islandora/base 镜像。请确保该基础镜像已正确获取（可通过 docker pull islandora/base 拉取），并参考 Base Image README 了解其配置要求。