flopes/spring-boot-docker

基于Alpine的轻量级Spring Boot Docker镜像 + Docker Compose配置

![]([] ![]([] ![Build Status]([***]

镜像概述

本镜像基于Alpine Linux和openjdk:8-jre-alpine构建，提供轻量级、安全的Spring Boot应用运行环境。通过Wrapper脚本处理进程信号，支持非root用户运行，同时提供灵活的配置选项，帮助开发者快速实现Spring Boot应用的容器化部署。

核心功能

• 采用轻量级openjdk:8-jre-alpine基础镜像，显著减少镜像体积
• 内置Wrapper脚本，确保应用进程成为容器PID 1并能接收SIGTERM信号
• 以spring-boot非root用户运行应用，提升容器安全性
• 支持自定义JAVA_OPTS参数，优化JVM运行配置
• 提供健康检查功能（对应镜像标签1.0-healthcheck）
• 支持调试模式，可配置调试端口

使用场景

• Spring Boot应用的容器化部署与运行
• 开发环境中快速搭建Spring Boot测试环境
• 多环境（开发/测试）下的应用配置管理
• 云原生场景下的轻量级应用部署

配置说明

环境变量

使用方法

1. 扩展镜像：在Dockerfile中引用本镜像

   dockerfile
   FROM flopes/spring-boot-docker:1.1
   

2. 构建镜像：将Spring Boot可执行Jar重命名为spring-boot.jar并放入assets目录，执行构建

   bash
   docker build -t spring-boot-image .
   

3. 运行应用
   • Docker CLI方式：

     bash
     docker run -d -p 8080:8080 spring-boot-image
     

   • Docker Compose方式：使用sample目录下的docker-compose.yml

     bash
     docker-compose up -d
     

注入环境变量示例

bash
docker run -d -p 8080:8080 -e JAVA_OPTS="-Xms256m -Xmx512m" spring-boot-image

Docker Compose配置

通过.env文件管理配置参数，示例内容：

env
# 应用参数
SERVER_PORT=8080
DEBUG_PORT=8000
SPRING_PROFILES_ACTIVE=dev
DEBUG=false
JAVA_OPTS=

# 主机映射参数
HOST_SERVER_PORT=8080
HOST_DEBUG_PORT=8000

调试模式

在.env中设置DEBUG=true，启动后通过DEBUG_PORT（默认8000）进行调试：

bash
docker-compose up -d

Spring Profiles

默认使用dev profile，可在.env中修改：

env
SPRING_PROFILES_ACTIVE=prod

PID 1处理验证

bash
# 启动容器
docker run -d --name spring-boot -p 8080:8080 spring-boot-image
# 进入容器查看进程
docker exec -it spring-boot sh
/app $ ps -ef
PID   USER     TIME   COMMAND
    1 spring-b   0:10 java -Djava.security.egd=file:/dev/./urandom -jar /app/spring-boot.jar
   23 spring-b   0:00 sh
   27 spring-b   0:00 ps -ef

应用进程作为PID 1运行，确保容器能正确响应停止信号。