执行bootBuildImage任务时出现Docker API 500错误如何解决？

这个偶发报错是多构建任务并发操作Docker镜像产生的冲突，Spring Boot 2.5.x版本自带的bootBuildImage任务默认会复用本地的pack系列构建镜像，Jenkins节点如果同时运行多个调用bootBuildImage的任务，就会出现某一个任务删除了公共构建镜像后，另一个任务还在尝试访问对应ID的镜像，触发500内部错误。本地开发环境一般都是单任务串行运行，不会触发这个冲突，手动重跑构建时并发任务的镜像操作已经完成，没有冲突所以可以正常构建。

可选择以下任意一种方案解决：

• 方案1：修改Gradle构建配置，为每个任务生成唯一的构建镜像名称，避免多个任务共享同一个构建镜像
  把如下配置加入build.gradle文件对应模块中：

bootBuildImage {
    // 配置唯一的构建镜像名称前缀，加入时间戳避免冲突
    builderName = "temp-builder-${project.name}-${System.currentTimeMillis()}"
    // 构建完成后自动清理临时构建镜像，节省节点存储空间
    cleanCache = true
}

如果使用Kotlin DSL的build.gradle.kts，对应配置为：

tasks.getByName<org.springframework.boot.gradle.tasks.bundling.BootBuildImage>("bootBuildImage") {
    builderName.set("temp-builder-${project.name}-${System.currentTimeMillis()}")
    cleanCache.set(true)
}

• 方案2：调整Jenkins构建环境隔离性，为每个构建任务分配独立的Docker运行环境，比如使用Docker-in-Docker容器执行构建，完全隔离不同任务的Docker操作，不会互相影响
• 方案3：升级Spring Boot版本到2.6.0及以上，该版本之后官方修复了bootBuildImage任务调用Docker API的并发安全问题，可直接解决这类偶发冲突

调整配置后可在Jenkins上同时触发多次同项目构建，验证问题是否解决。

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