gookit/jdk

镜像概述

本Docker镜像专为Java应用的容器化部署设计，旨在简化Java应用的启动配置、版本更新及前置脚本执行流程。通过环境变量灵活配置，结合自动JAR文件更新机制，实现Java应用的便捷部署与维护。

核心功能与特性

1. 环境变量配置

支持通过环境变量指定以下关键参数：

• 工作命令
• JAR文件名称
• JAR文件启动命令行参数

2. JAR文件自动更新

通过检测容器内是否存在文件名以"_new.jar"结尾的文件，自动识别并更新JAR文件。更新流程会保留原JAR文件的校验信息，确保更新准确性。

3. 外部脚本前置执行

允许通过环境变量指定外部脚本路径，在JAR文件启动命令执行前，自动运行该脚本，支持应用启动前的初始化操作（如配置文件预处理、依赖检查等）。

使用场景

• Java应用的容器化部署，需灵活配置启动参数
• 需要频繁更新JAR文件版本的场景
• 应用启动前需执行自定义初始化逻辑（如数据库迁移、配置注入等）

使用方法与配置说明

环境变量说明

部署示例

docker run命令示例

bash
docker run -d \
  -e JAR_NAME=hello \
  -e JAR_ARGS="-Dfile.encoding=utf-8 -Duser.timezone=Asia/Shanghai" \
  -e EXT_SCRIPT_PATH="/gookit_runtime/before_update_jar_file.sh" \
  -v /host/path/to/scripts:/gookit_runtime \
  -v /host/path/to/jars:/gookit_runtime \
  docker.xuanyuan.run/your-image-name

JAR文件更新流程

1. 将新版本JAR文件命名为[JAR_NAME]_new.jar（如hello_new.jar）并挂载到容器内JAR目录
2. 容器检测到_new.jar文件后，自动执行更新：
   • 保留原JAR文件校验信息
   • 替换原JAR文件为新文件
   • 输出更新日志

启动日志示例

------------ ext script start---------------
======= Will execute the corresponding contents of the external script before updating the JAR package =======
The external script was successfully executed: /gookit_runtime/before_update_jar_file.sh
------------ ext script end-----------------
------------ update before start-------------------
-rw-r--r-- 1 root root *** Sep 26 11:11 /gookit_runtime/hello.jar
280fd0d51055e486b942f***a34de  /gookit_runtime/hello.jar
------------ update before end---------------------
------------ update start------------------
-rw-r--r-- 1 root root *** Sep 26 11:11 /gookit_runtime/hello_new.jar
280fd0d51055e486b942f***a34de  /gookit_runtime/hello_new.jar
succeeded in updating the JAR file: /gookit_runtime/hello_new.jar
------------ update end--------------------
------------ current start------------
-rw-r--r-- 1 root root *** Sep 26 11:11 /gookit_runtime/hello.jar
280fd0d51055e486b942f***a34de  /gookit_runtime/hello.jar
------------ current end--------------
java version "1.8.0_291"
Java(TM) SE Runtime Environment (build 1.8.0_291-b10)
Java HotSpot(TM) 64-Bit Server VM (build 25.291-b10, mixed mode)
java -Dfile.encoding=utf-8 -Duser.timezone=Asia/Shanghai -jar /gookit_runtime/hello.jar