marceloagmelo/java8

SpringBoot微服务Docker镜像

镜像概述

本镜像基于CentOS7构建，包含OpenJDK 1.8和Prometheus，初始设计用于SpringBoot微服务，也可支持任意Java守护进程。镜像暴露8080端口，Java进程由"java"用户执行，所有组件（Java进程、Prometheus Agent）的日志均输出到标准输出和标准错误流。

核心功能

1. 支持多种操作命令：help（查看帮助）、info（显示镜像元数据）、start（启动Java进程）、status（查看运行进程信息）、shell（启动bash shell）、threaddump（生成线程dump）、heapdump（生成堆dump）
2. 灵活的环境变量配置：可自定义Java运行参数、应用部署路径、JAR文件位置等
3. 支持从HTTP/HTTPS服务器下载artifact（jar/zip/tgz格式）
4. 可基于本镜像构建新的SpringBoot应用镜像
5. 时区可通过环境变量调整

使用场景

• SpringBoot微服务的容器化部署环境
• 需要Prometheus监控的Java应用运行场景
• Java守护进程的标准化容器运行环境

配置说明

镜像下载

bash
docker pull docker.xuanyuan.run/marceloagmelo/java8:latest

常用操作示例

查看帮助

bash
docker run --rm -ti docker.xuanyuan.run/marceloagmelo/java8:latest help

输出示例：

========================================
USAGE: /control.sh COMMAND [args]
  Command list:
    - info      : execute info scripts
    - shell     : execute shell scripts
    - start     : execute start scripts
    - status    : execute status scripts
    - test      : execute test scripts
    - threaddump  : Thread dump is created in system out
    - heapdump    : Heap dump file is created in /tmp/jvm.hprof
========================================

查看镜像元数据

bash
docker run --rm -ti docker.xuanyuan.run/marceloagmelo/java8:latest info

输出示例：

com.produban.components=java8, prometheus
com.produban.description=Java 8 runtime for Spring boot microservices
com.produban.imageowner=Products and Services

启动应用

默认从/opt/app目录查找第一个JAR文件，若无则使用/application.jar测试应用：

bash
docker run -d -p 8080:8080 docker.xuanyuan.run/marceloagmelo/java8:latest start

启动bash shell

bash
docker run --rm -ti docker.xuanyuan.run/marceloagmelo/java8:latest shell

环境变量配置

• JAVA_OPTS_EXT：添加Java运行参数或属性
  示例：

  bash
  docker run -e JAVA_OPTS_EXT="-Dapp.title=Test -Xms256M" -d -p 8080:8080 docker.xuanyuan.run/marceloagmelo/java8:latest start
  

• APP_HOME：应用部署目录（默认/opt/app），用于放置JAR、证书、配置文件等
• JAR_PATH：指定应用JAR文件路径（默认取APP_HOME下第一个JAR）
  示例：

  bash
  docker run -e JAR_PATH="/opt/app/vivaFluminense.jar" -d -p 8080:8080 docker.xuanyuan.run/marceloagmelo/java8:latest start
  

• ARTIFACT_URL：从HTTP/HTTPS服务器下载artifact（支持jar/zip/tgz格式）
• TZ：设置时区（默认America/Sao_Paulo）
  示例：

  bash
  docker run -e TZ="Asia/Shanghai" -d -p 8080:8080 docker.xuanyuan.run/marceloagmelo/java8:latest start
  

基于本镜像构建新应用

Dockerfile示例：

dockerfile
FROM docker.xuanyuan.run/marceloagmelo/java8:latest
ADD configuration.jar /opt/app
ADD mykey.key /opt/app
ADD mycert.crt /opt/app

构建命令：

bash
docker build .