将 Gradle 与 Docker 结合实现一键构建镜像并推送仓库，可通过 Gradle 脚本（build.gradle 或 build.gradle.kts）整合 Docker 命令，结合插件简化流程。以下是详细实现方案：

一、环境准备

1. 本地安装 Docker 并启动（确保 docker 命令可在终端执行）
2. 确保有 Docker 仓库账号（如 Docker Hub、阿里云容器仓库、私有仓库等）
3. Gradle 项目已初始化（Java/Kotlin 等均可）

二、核心实现方案

推荐使用 com.bmuschko:gradle-docker-plugin 插件，它封装了 Docker 命令，简化镜像构建、推送等操作。

步骤 1：引入 Docker 插件

在 build.gradle（Groovy 语法）中添加插件依赖：

plugins {
    id 'java'  // 或其他语言插件（如org.jetbrains.kotlin.jvm）
    id 'com.bmuschko.docker-remote-api' version '9.3.1'  // Docker插件
}

// 仓库配置（用于下载插件）
repositories {
    mavenCentral()
}

插件版本可参考 官方最新版。

步骤 2：配置 Docker 镜像信息

在 build.gradle 中添加镜像构建和推送的配置：

// Docker 配置
docker {
    // 连接本地Docker（默认地址，通常无需修改）
    url = 'unix:///var/run/docker.sock'  // Linux/Mac
    // url = 'tcp://localhost:2375'  // Windows（需开启Docker远程访问）
}

// 构建Docker镜像任务
task buildDockerImage(type: com.bmuschko.gradle.docker.tasks.image.DockerBuildImage) {
    // 镜像名称（格式：仓库地址/项目名:版本号）
    images = [
        "your-registry.com/your-project:${project.version}",  // 私有仓库
        "docker.io/your-username/your-project:${project.version}"  // Docker Hub示例
    ]
    // Dockerfile所在目录（默认项目根目录，可修改为src/main/docker等）
    dockerFile = file('Dockerfile')
    // 构建上下文目录（通常为项目根目录，确保Dockerfile中COPY的文件路径正确）
    contextDir = file('.')
}

// 推送Docker镜像任务
task pushDockerImage(type: com.bmuschko.gradle.docker.tasks.image.DockerPushImage) {
    // 需与构建的镜像名称一致
    images = buildDockerImage.images
    // 仓库认证（建议通过环境变量传入，避免硬编码）
    registryCredentials {
        url = 'https://your-registry.com'  // 仓库地址（Docker Hub可省略）
        username = System.getenv('DOCKER_USERNAME')  // 环境变量获取用户名
        password = System.getenv('DOCKER_PASSWORD')  // 环境变量获取密码
    }
    // 依赖构建任务（先构建再推送）
    dependsOn buildDockerImage
}

// 可选：将推送任务绑定到Gradle生命周期（如构建后自动推送）
build.finalizedBy(pushDockerImage)

步骤 3：编写 Dockerfile

在项目根目录创建 Dockerfile（根据项目类型调整），以 Spring Boot 项目为例：

# 基础镜像（JDK版本根据项目调整）
FROM eclipse-temurin:17-jre-alpine

# 工作目录
WORKDIR /app

# 复制构建产物（Gradle构建的JAR包路径）
COPY build/libs/*.jar app.jar

# 暴露端口（根据项目端口调整）
EXPOSE 8080

# 启动命令
ENTRYPOINT ["java", "-jar", "app.jar"]

步骤 4：执行一键构建与推送

1. 设置仓库认证信息（避免硬编码密码）：

   # 终端中临时设置环境变量（Linux/Mac）
   export DOCKER_USERNAME=你的仓库用户名
   export DOCKER_PASSWORD=你的仓库密码（或访问令牌）
   

2. 执行 Gradle 命令：

   # 构建项目 -> 构建Docker镜像 -> 推送镜像到仓库
   ./gradlew clean build pushDockerImage
   

   • Windows 系统使用 gradlew.bat clean build pushDockerImage

三、关键配置说明

1. 镜像命名规范：
   镜像名称需包含仓库地址（如私有仓库 your-registry.com/xxx，Docker Hub 可简化为 username/xxx），否则默认推送到 Docker Hub 公共仓库。

2. 仓库认证：

   • 私有仓库必须配置 registryCredentials，Docker Hub 可省略 url（默认 https://index.docker.io/v1/）。
   • 生产环境建议通过 CI/CD 平台的「密钥管理」传递认证信息（如 Jenkins、GitHub Actions 的 Secrets）。

3. 任务依赖：
   pushDockerImage 依赖 buildDockerImage，buildDockerImage 隐含依赖项目构建任务（如 jar），确保先编译再打包镜像。

四、进阶优化

1. 多环境镜像标签：
   可根据环境添加标签（如 latest、dev、prod）：

   images = [
       "your-registry.com/your-project:${project.version}",
       "your-registry.com/your-project:latest"
   ]
   

2. 跳过测试（可选）：
   快速构建时可跳过测试：./gradlew clean build pushDockerImage -x test

3. CI/CD 集成：
   在 GitHub Actions 中配置自动构建推送（示例 .github/workflows/docker.yml）：

   name: Build and Push Docker
   on: [push]
   jobs:
     build:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v4
         - name: Set up JDK 17
           uses: actions/setup-java@v4
           with: { java-version: '17', distribution: 'temurin' }
         - name: Build and push
           env:
             DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}
             DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
           run: ./gradlew clean build pushDockerImage
   

通过以上配置，即可实现一条命令完成从项目构建到 Docker 镜像推送的全流程，适合开发环境快速迭代或 CI/CD 自动化部署。