使用Gradle插件时，如何按环境切换Jib镜像仓库？

下面提供三种实用方案，帮你不用手动修改配置就能在本地测试和ECR部署之间切换：

方案一：动态属性切换镜像地址 #

修改现有Jib配置，让镜像地址根据Gradle属性动态取值，默认使用本地镜像名，需要部署ECR时通过参数覆盖：

id 'com.google.cloud.tools.jib' version '3.1.4'
...
jib {
  from {
    image = 'amazoncorretto:20'
  }
  to {
    // 默认本地镜像名，传-Ddocker.image参数时替换为ECR地址
    image = project.findProperty('docker.image') ?: 'cbusha-backend:latest'
  }
}

执行命令 #

• 本地构建到Docker（用于测试）：

  ./gradlew jibDockerBuild
  

• 部署到AWS ECR：

  ./gradlew jib -Ddocker.image=660315312345.dkr.ecr.us-east-2.amazonaws.com/cbusha-backend:latest
  

注意事项 #

部署ECR前需先完成AWS ECR登录，确保Jib能获取认证信息：

aws ecr get-login-password --region us-east-2 | docker login --username AWS --password-stdin 660315312345.dkr.ecr.us-east-2.amazonaws.com

方案二：自定义ECR专属任务 #

如果不想每次传参数，可以单独定义一个用于ECR部署的Jib任务，和本地配置完全分离：

id 'com.google.cloud.tools.jib' version '3.1.4'
...
// 本地构建配置（用于测试）
jib {
  from {
    image = 'amazoncorretto:20'
  }
  to {
    image = 'cbusha-backend:latest'
  }
  // 可添加容器配置（如端口、环境变量），后续ECR任务可复用
  container {
    ports = ['8080']
  }
}

// 自定义ECR部署任务
task jibEcr(type: com.google.cloud.tools.jib.gradle.JibTask) {
  from {
    image = 'amazoncorretto:20'
  }
  to {
    image = '660315312345.dkr.ecr.us-east-2.amazonaws.com/cbusha-backend:latest'
  }
  // 复用本地任务的容器配置，避免重复编写
  container {
    inheritFrom jib.container
  }
}

执行命令 #

• 本地构建测试：

  ./gradlew jibDockerBuild
  

• 部署到ECR：

  ./gradlew jibEcr
  

方案三：环境变量驱动（适合CI/CD场景） #

如果是在CI流水线中使用，用环境变量控制镜像地址更灵活：

id 'com.google.cloud.tools.jib' version '3.1.4'
...
jib {
  from {
    image = 'amazoncorretto:20'
  }
  to {
    // 优先读取环境变量DOCKER_IMAGE，不存在则用本地镜像名
    image = System.getenv('DOCKER_IMAGE') ?: 'cbusha-backend:latest'
  }
}

执行命令 #

• 本地构建：

  ./gradlew jibDockerBuild
  

• 部署ECR（Linux/macOS）：

  DOCKER_IMAGE=660315312345.dkr.ecr.us-east-2.amazonaws.com/cbusha-backend:latest ./gradlew jib
  

• 部署ECR（Windows PowerShell）：

  $env:DOCKER_IMAGE="660315312345.dkr.ecr.us-east-2.amazonaws.com/cbusha-backend:latest"; ./gradlew jib
  

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