Spring Boot 3.x自定义Dockerfile及扩展Native镜像方法咨询

一、直接通过bootBuildImage添加额外软件包 #

你可以利用Spring Boot Buildpack的环境变量配置，在构建镜像时自动安装系统软件包，无需编写自定义Dockerfile：

在build.gradle中添加bootBuildImage的配置块：

tasks.named('bootBuildImage') {
    // 可选：指定基于jammy版本的builder镜像，适配Ubuntu 22.04的软件包
    builder = 'paketobuildpacks/builder-jammy-base:latest'
    // 通过BP_SYSTEM_PACKAGES环境变量指定要安装的软件包，多个用空格分隔
    environment = [
        "BP_SYSTEM_PACKAGES": "curl vim"
    ]
}

执行gradle bootBuildImage重新构建镜像，启动容器后即可使用安装的软件包。

二、使用自定义Dockerfile构建镜像 #

如果需要更灵活的镜像定制（比如复杂的环境配置、多阶段构建），可以先生成Native可执行文件，再通过Dockerfile打包：

步骤1：生成Native可执行文件 #

执行以下命令编译生成Native镜像可执行文件：

gradle nativeBuild

生成的可执行文件默认位于build/native/nativeCompile/目录下，文件名与你的项目名称一致（示例中为spring305gradlenativeimage）。

步骤2：编写自定义Dockerfile #

在项目根目录创建Dockerfile，示例如下（基于Ubuntu轻量镜像）：

# 选择基础镜像，这里用Ubuntu 22.04最小镜像
FROM ubuntu:jammy-minimal

# 安装额外软件包，清理apt缓存减小镜像体积
RUN apt-get update && apt-get install -y --no-install-recommends \
    curl \
    vim \
    && rm -rf /var/lib/apt/lists/*

# 创建非root用户运行应用（安全最佳实践）
RUN useradd -m appuser
USER appuser

# 复制Native可执行文件到镜像内
COPY build/native/nativeCompile/spring305gradlenativeimage /app/

# 设置工作目录
WORKDIR /app

# 暴露应用监听的端口（示例为8080）
EXPOSE 8080

# 启动应用
CMD ["./spring305gradlenativeimage"]

如果偏好Alpine镜像（更小体积），需要处理GraalVM Native可执行文件依赖的glibc问题，Dockerfile示例：

FROM alpine:3.18

# 安装glibc及所需软件包
RUN apk add --no-cache curl vim glibc

# 创建非root用户
RUN adduser -D appuser
USER appuser

COPY build/native/nativeCompile/spring305gradlenativeimage /app/
WORKDIR /app
EXPOSE 8080
CMD ["./spring305gradlenativeimage"]

步骤3：构建并运行镜像 #

执行Docker构建命令：

docker build -t spring305gradlenativeimage:0.0.1-SNAPSHOT .

构建完成后，用原命令启动容器即可：

docker run spring305gradlenativeimage:0.0.1-SNAPSHOT

内容的提问来源于stack exchange，提问作者Paul Verest on LinkedIn