5b1t/openjre

openjre 镜像文档

镜像概述

openjre镜像是基于alpine3.15构建的轻量级Java运行环境镜像，提供OpenJRE 8和17两个版本，适用于Java应用的容器化部署。该镜像集成实用工具，支持服务依赖管理和应用自动重启，简化Java应用的容器化配置流程。

核心功能与特性

• 轻量级基础：基于alpine3.15，镜像体积小，资源占用低
• 多版本支持：提供OpenJRE 8和17两个常用版本
• 服务依赖管理：内置wait-for工具，支持等待其他服务端口可用后启动应用
• 自动重启机制：集成start.sh脚本，可监听JAR文件变动并自动重启应用

使用场景

• 需要依赖数据库、缓存等其他服务的Java应用部署
• 开发环境中需要频繁更新JAR包并自动重启的场景
• 对镜像体积和资源占用有要求的Java应用容器化场景

使用方法

1. 普通使用

适用于无需依赖其他服务的简单Java应用部署。

yaml
services:
  openjre:
    image: openjre:17  # 或使用 openjre:8
    container_name: system
    volumes:
      - /data/app:/srv/app  # 挂载本地JAR文件目录到容器内/srv/app
    restart: always
    ports:
      - "8080:8080"  # 映射应用端口
    command: "java -jar /srv/app/system.jar"  # 运行JAR文件
    networks:
      system-network:
        ipv4_address: 172.16.9.10  # 固定容器IP

networks:
  system-network:
    driver: bridge
    ipam:
      config:
        - subnet: 172.16.9.0/24  # 自定义网络子网

2. 使用wait-for工具等待依赖服务

适用于需要依赖其他服务（如数据库、Redis）的应用，确保依赖服务可用后再启动应用。

yaml
services:
  openjre:
    image: openjre:17  # 或使用 openjre:8
    container_name: system
    volumes:
      - /data/app:/srv/app
    restart: always
    ports:
      - "8080:8080"
    # 等待mariadb(3306端口)和redis(6379端口)可用后启动JAR
    command: "/srv/tool/wait-for -t 0 192.168.1.101:3306 192.168.1.101:6379 -- java -jar /srv/app/system.jar"
    networks:
      system-network:
        ipv4_address: 172.16.9.10

networks:
  system-network:
    driver: bridge
    ipam:
      config:
        - subnet: 172.16.9.0/24

wait-for参数说明：

• -t 0：无限期等待，直到所有指定服务可用
• 后续参数为需要等待的服务地址和端口，多个服务用空格分隔
• --：分隔wait-for参数和实际启动命令

3. 使用start.sh实现自动重启

适用于需要监听JAR文件变动并自动重启的场景，通过设置JAVA_CMD环境变量定义启动命令。

yaml
services:
  openjre:
    image: openjre:17  # 或使用 openjre:8
    container_name: system
    environment:
      # 定义启动命令，支持结合wait-for使用
      - JAVA_CMD=/srv/tool/wait-for -t 0 192.168.1.101:3306 192.168.1.101:6379 -- java -jar /srv/app/system.jar
    volumes:
      - /data/app:/srv/app  # 挂载目录，当/srv/app/system.jar变动时触发重启
    restart: always
    ports:
      - "8080:8080"
    command: "/srv/tool/start.sh"  # 使用start.sh作为启动脚本
    networks:
      system-network:
        ipv4_address: 172.16.9.10

networks:
  system-network:
    driver: bridge
    ipam:
      config:
        - subnet: 172.16.9.0/24

工作原理：start.sh脚本会监听JAVA_CMD中指定的JAR文件（如示例中的/srv/app/system.jar），当文件被覆盖或修改时，自动终止当前进程并重新执行JAVA_CMD命令，实现应用自动重启。