buzzxu/java

docker-java 镜像文档

镜像概述

docker-java是一个基于Java 15的Docker镜像，旨在提供标准化的Java运行环境。该镜像预设了Asia/Shanghai时区和C.UTF-8编码，确保应用在容器化部署时具有一致的运行环境配置，简化Java应用的容器化流程。

核心功能与特性

• Java环境：内置Java 15运行时环境，JAVA_HOME路径为/opt/jre
• 时区配置：默认设置为Asia/Shanghai时区，避免因时区差异导致的应用时间问题
• 编码支持：默认采用C.UTF-8编码，确保中文等特殊字符正常处理
• 环境变量集成：关键路径已添加至PATH，可直接在容器内执行java等命令

环境变量说明

使用场景

• Java应用程序的容器化部署
• 开发环境中的Java运行环境快速搭建
• 需要统一时区和编码配置的Java服务部署

使用方法

基本运行

通过以下命令启动容器，进入Java环境：

shell
docker run -it --rm docker-java java -version

运行Java应用

将本地Java应用JAR包挂载到容器中运行：

shell
docker run -it --rm -v /path/to/your/app.jar:/app.jar docker-java java -jar /app.jar

自定义配置

如需修改时区或编码，可在运行时覆盖环境变量：

shell
# 修改时区为UTC
docker run -it --rm -e TZ=UTC docker-java date

# 修改编码为GBK（需镜像支持对应编码）
docker run -it --rm -e LANG=zh_CN.GBK -e LC_ALL=zh_CN.GBK docker-java locale

Docker Compose示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  java-app:
    image: docker-java
    environment:
      - TZ=Asia/Shanghai
      - LANG=C.UTF-8
    volumes:
      - ./app.jar:/app.jar
    command: java -jar /app.jar

启动服务：

shell
docker-compose up