使用JIB构建容器遇阻：Gradle配置FROM与TO项求助

1. 确认插件引入正确性 #

首先确保在 build.gradle 的插件块中引入兼容 Gradle 9 的 JIB 版本（推荐 3.4.0 及以上）：

plugins {
    id 'java'
    id 'com.google.cloud.tools.jib' version '3.4.0'
}

2. 配置 from 块（基础镜像） #

JIB 必须指定基础镜像，针对 JDK 21 推荐两种选项：

• 轻量生产级镜像：使用 Google Distroless 镜像，仅包含运行 Java 程序所需的最小依赖

  jib {
      from {
          image = 'gcr.io/distroless/java21-debian12'
      }
  }
  

• 通用调试/开发镜像：使用 Eclipse Temurin 官方 JRE 镜像，包含更多工具便于调试

  jib {
      from {
          image = 'docker.io/library/eclipse-temurin:21-jre'
      }
  }
  

3. 配置 to 块（指向 GCP Artifact Registry） #

GCP Artifact Registry 的镜像地址格式为：{区域}-docker.pkg.dev/{GCP项目ID}/{仓库名称}/{镜像名称}:{标签}
替换为你的实际信息后，配置如下：

jib {
    to {
        image = 'us-central1-docker.pkg.dev/my-gcp-project/my-artifact-repo/my-java-app:v1.0.0'
        // 如果需要每次构建自动生成唯一标签，可使用如下配置替代固定标签
        // tags = ['latest', "${System.getenv('BUILD_NUMBER') ?: 'local'}"]
    }
}

注意：确保你已在 GCP 中创建对应区域的 Artifact Registry 仓库，且仓库类型为 Docker

4. GCP 身份认证（本地开发） #

本地构建时，JIB 会自动读取 gcloud CLI 的凭据，只需执行以下命令完成认证：

gcloud auth login
gcloud auth configure-docker {区域}-docker.pkg.dev

替换命令中的 {区域} 为你 Artifact Registry 所在的区域（如 us-central1）

5. 执行构建部署 #

运行以下 Gradle 命令直接推送镜像至 GCP Artifact Registry：

./gradlew jib

如果需要先构建本地镜像测试，可使用：

./gradlew jibBuildTar
# 加载本地镜像到 Docker（若仍需临时使用 Docker 验证）
docker load --input build/libs/jib-image.tar

常见问题排查 #

• 若提示权限错误：检查当前 gcloud 账号是否拥有 Artifact Registry 的推送权限（需分配 roles/artifactregistry.writer 角色）
• 若 Gradle 同步失败：确认 JIB 插件版本与 Gradle 9 兼容，可尝试升级至最新稳定版
• 若镜像启动失败：检查基础镜像与 JDK 版本匹配，Distroless 镜像需确保程序无额外系统依赖

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