Spring Boot Gradle插件额外CA证书绑定配置示例求助

问题详情 #

我需要在Spring Boot Gradle插件中指定额外CA证书绑定，先后尝试了两种配置方式：

第一种配置：

bootBuildImage {
  bindings = [ "${project.projectDir}/bindings/ca-certificates:/platform/bindings/ca-certificates" ]
}

第二种配置：

bootBuildImage {
    bindings = ['./bindings/ca-certificates:/platform/bindings/ca-certificates']
}

执行bootBuildImage任务时触发如下错误：

2023-01-09T16:28:11.799+0800 [ERROR] [org.gradle.internal.buildevents.BuildExceptionReporter] 
Execution failed for task ':ProjectA:bootBuildImage'.
> Docker API call to 'localhost/v1.24/containers/create' failed with status code 500 "Internal Server Error"

移除绑定配置后错误消失，但公司代理环境下（代理会替换网站证书为内部证书），会出现预期内的TLS证书验证失败问题。

使用版本信息：

• Docker 4.8.2（Docker 20.10.14）
• Spring Boot 3.0.1
• GraalVM插件 org.graalvm.buildtools.native:0.9.19

解决方案 #

1. 检查本地目录的有效性 #

• 确认本地./bindings/ca-certificates目录存在，且包含正确的CA证书文件（通常命名为ca.crt或cert.pem）
• 确保Docker对该目录有读取权限，Linux/macOS下可执行：

  chmod -R 755 ./bindings/ca-certificates
  

2. 使用绝对路径避免解析异常 #

相对路径在部分Docker环境中可能解析失败，建议显式生成绝对路径：

bootBuildImage {
    def caCertAbsolutePath = project.file('bindings/ca-certificates').absolutePath
    bindings = ["$caCertAbsolutePath:/platform/bindings/ca-certificates"]
}

3. 配合Buildpack环境变量完成证书信任 #

通过BP_JVM_TRUST_CERTS环境变量指定证书目录，确保Buildpack正确加载证书：

bootBuildImage {
    environment = [
        "BP_JVM_TRUST_CERTS": "/platform/bindings/ca-certificates"
    ]
    bindings = [project.file('bindings/ca-certificates').absolutePath + ":/platform/bindings/ca-certificates"]
}

4. 替代方案：直接嵌入证书到构建包 #

如果目录绑定仍有问题，可将证书放入src/main/resources/ssl，通过extraDirectories复制到容器内并指定信任：

bootBuildImage {
    buildpacks = ["gcr.io/paketo-buildpacks/java-native-image"]
    environment = [
        "BP_JVM_TRUST_CERTS": "/workspace/ssl"
    ]
    extraDirectories {
        into = "/workspace/ssl"
        from = "src/main/resources/ssl"
    }
}

5. 排查Docker Daemon问题 #

Docker API 500错误多为Daemon端异常，可尝试：

• 重启Docker服务后重试
• 查看Docker日志（Docker Desktop可通过「设置->Resources->Advanced」查看），确认是否存在目录挂载相关错误

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