harisekhon/ubuntu-java

harisekhon/ubuntu-java Docker镜像文档

镜像概述和主要用途

harisekhon/ubuntu-java 是基于Ubuntu操作系统的Java运行和开发环境镜像，采用OpenJDK构建，提供多种Java版本（7、8、9）及JRE/JDK变体。该镜像旨在为Java应用提供稳定、标准化的运行时和开发环境，尤其适用于Hadoop、大数据生态系统及DevOps工具链的开发与部署场景。

主要用途

• Java应用程序的开发与编译环境（JDK版本）
• Java应用程序的运行时环境（JRE版本）
• 作为大数据工具（如Hadoop、Spark、Kafka）的基础依赖镜像
• 集成到CI/CD流程中，提供一致的Java环境

核心功能和特性

基础特性

• 稳定基础：基于官方Ubuntu镜像，确保系统级依赖的稳定性
• OpenJDK支持：采用OpenJDK（避免Oracle Java许可限制），提供Java 7、8、9版本
• JRE/JDK分离：提供JRE（运行时）和JDK（开发工具包）两种变体，按需选择
• 预配置环境：自动设置JAVA_HOME环境变量，无需手动配置

版本支持

• Java版本：7、8、9（对应OpenJDK官方版本）
• Ubuntu版本：Ubuntu 14.04（Java 7）及Ubuntu最新版（Java 8、9）
• 变体：每个Java版本均提供JRE（精简运行时）和JDK（含编译器及开发工具）

使用场景和适用范围

典型场景

1. 开发环境：使用JDK版本进行Java应用开发、编译和调试
2. 生产运行时：使用JRE版本部署轻量级Java应用，减少镜像体积
3. 大数据工具依赖：作为Hadoop、Spark、Flink等大数据框架的基础镜像
4. CI/CD集成：在自动化流水线中提供标准化Java环境，确保构建一致性
5. 测试环境：快速搭建多版本Java测试环境，验证应用兼容性

适用范围

• Java开发者和运维工程师
• 大数据平台搭建（如Hadoop生态系统）
• 需要跨Java版本测试的场景
• 对Ubuntu系统有依赖的Java应用

标签说明

镜像通过标签区分Java版本、变体（JRE/JDK）及基础Ubuntu版本，格式为[jdk|jre]<version>，具体标签如下：

使用方法和配置说明

前提条件

• 已安装Docker Engine（1.13+）
• 网络可访问DockerHub（用于拉取镜像）

镜像拉取

通过docker pull命令拉取指定标签的镜像：

bash
# 拉取JDK 8（默认latest标签）
docker pull docker.xuanyuan.run/harisekhon/ubuntu-java:latest

# 拉取JRE 8
docker pull docker.xuanyuan.run/harisekhon/ubuntu-java:jre8

# 拉取JDK 7（基于Ubuntu 14.04）
docker pull docker.xuanyuan.run/harisekhon/ubuntu-java:jdk7

基本使用（docker run）

1. 运行交互式容器（验证Java版本）

bash
# 使用JDK 8，进入bash终端
docker run -it --rm docker.xuanyuan.run/harisekhon/ubuntu-java:jdk8 bash

# 在容器内验证Java版本和JAVA_HOME
java -version
echo $JAVA_HOME  # 输出：/usr/lib/jvm/java-8-openjdk-amd64

2. 运行Java应用（挂载本地JAR文件）

假设本地有app.jar需运行，使用JRE 8环境：

bash
docker run -it --rm -v $(pwd):/app -w /app docker.xuanyuan.run/harisekhon/ubuntu-java:jre8 java -jar app.jar

3. 作为开发环境（编译Java代码）

使用JDK 8编译当前目录下的Java文件：

bash
docker run -it --rm -v $(pwd):/src -w /src docker.xuanyuan.run/harisekhon/ubuntu-java:jdk8 javac Main.java

Docker Compose配置示例

创建docker-compose.yml，定义一个依赖Java 8 JDK的服务：

yaml
version: '3'
services:
  java-app:
    image: docker.xuanyuan.run/harisekhon/ubuntu-java:jdk8
    container_name: java-dev-env
    volumes:
      - ./code:/app  # 挂载本地代码目录
    working_dir: /app
    command: bash -c "javac Main.java && java Main"  # 编译并运行应用
    environment:
      - JAVA_OPTS="-Xms512m -Xmx1g"  # 自定义JVM参数

启动服务：

bash
docker-compose up

环境变量

镜像预配置以下环境变量，可直接使用或覆盖：

高级配置

自定义JVM参数

运行容器时通过-e覆盖JAVA_OPTS：

bash
docker run -it --rm -e JAVA_OPTS="-Xms1g -Xmx2g -XX:+UseG1GC" docker.xuanyuan.run/harisekhon/ubuntu-java:jre8 java $JAVA_OPTS -jar app.jar

暴露应用端口

若Java应用监听端口8080，需在运行时映射端口：

bash
docker run -it --rm -p 8080:8080 docker.xuanyuan.run/harisekhon/ubuntu-java:jre8 java -jar webapp.jar

构建从源码（可选）

如需从源码构建镜像，可克隆GitHub仓库并执行构建：

bash
# 克隆仓库
git clone https://github.com/harisekhon/Dockerfiles.git
cd Dockerfiles/ubuntu-java

# 构建指定版本（如JDK 8）
make build

注：默认构建基于最新Ubuntu的JDK 8，其他版本可通过检出对应分支（如ubuntu-java-7）构建。

支持与反馈

问题反馈

如遇镜像相关问题，可在GitHub仓库提交issue：
https://github.com/harisekhon/Dockerfiles/issues

相关资源

• DockerHub仓库：https://hub.docker.com/u/harisekhon/
• GitHub源码：https://github.com/harisekhon/Dockerfiles
• 依赖工具：https://github.com/harisekhon/devops-python-tools%EF%BC%88%E5%90%AB%E9%95%9C%E5%83%8F%E6%B5%8B%E8%AF%95%E4%B8%8E%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7%EF%BC%89