如何使用Spring Boot Gradle插件结合buildpack构建带额外包的OCI镜像

Spring Boot Gradle插件的bootBuildImage任务基于Cloud Native Buildpacks实现镜像构建，你可以通过以下两种方式注入自定义逻辑，完成额外软件的下载、安装与配置：

方案1：使用Apt Buildpack（推荐，适配大部分场景） #

该方案借助Paketo官方提供的Apt扩展buildpack实现系统依赖、自定义软件的安装，操作成本最低：

• 第一步：在项目根目录创建apt.yml配置文件，定义构建逻辑：

---
apt:
  # 定义需要预安装的系统依赖包
  packages:
    - curl
    - wget
  # 安装前执行的bash命令，可用于添加第三方软件源、导入签名密钥等
  pre_install: |
    curl -fsSL https://your-custom-repo/key.gpg | gpg --dearmor -o /etc/apt/trusted.gpg.d/custom-repo.gpg
    echo "deb https://your-custom-repo/deb stable main" > /etc/apt/sources.list.d/custom.list
  # 安装后执行的bash命令，可用于下载自定义软件包、修改配置等
  post_install: |
    # 示例：下载自定义软件包并安装
    curl -o /tmp/your-package.tar.gz https://internal-resource.com/your-package.tar.gz
    mkdir -p /opt/your-package
    tar -zxf /tmp/your-package.tar.gz -C /opt/your-package --strip-components=1
    chmod +x /opt/your-package/bin/*
    # 写入环境变量确保软件可全局调用
    echo "export PATH=\$PATH:/opt/your-package/bin" > /etc/profile.d/your-package.sh

• 第二步：修改build.gradle中的bootBuildImage任务配置：

bootBuildImage {
    // 选择基础builder镜像，可根据需求替换为full版本
    builder = "paketobuildpacks/builder-jammy-base:latest"
    // 指定构建使用的buildpack列表，Apt buildpack需放在Java buildpack之前执行
    buildpacks = [
        "gcr.io/paketo-buildpacks/apt",
        "gcr.io/paketo-buildpacks/java"
    ]
    // 将本地apt配置文件绑定到构建环境的指定路径
    bindings = [
        "${project.rootDir}/apt.yml:/platform/bindings/apt/apt.yml"
    ]
    // 可选配置：自定义镜像名、版本等参数
    imageName = "your-application:${project.version}"
}

方案2：注入预构建脚本（适配复杂定制需求） #

如果你的自定义逻辑不适合用Apt配置实现，可以直接编写独立的执行脚本，注入到构建流程的预构建阶段执行：

• 第一步：在项目根目录创建custom-build.sh脚本，写入所有你需要执行的curl下载、软件安装、配置修改逻辑
• 第二步：修改bootBuildImage任务配置：

bootBuildImage {
    builder = "paketobuildpacks/builder-jammy-base:latest"
    environment = [
        "BP_PRE_BUILD_SCRIPT" : "/platform/bindings/scripts/custom-build.sh"
    ]
    bindings = [
        "${project.rootDir}/custom-build.sh:/platform/bindings/scripts/custom-build.sh"
    ]
}

注意：构建阶段写入的文件如果需要保留到最终运行镜像中，需确保写入路径属于buildpack定义的可持久层路径，或写入到应用工作目录、launcher可访问的公共路径下。

内容的提问来源于stack exchange，提问作者Bartosz Bilicki