实战Spring Boot 2.0系列(一) - 使用Gradle构建Docker镜像

时间  2019-11-08
标签 实战 spring boot 2.0 系列 使用 gradle 构建 docker 镜像 栏目 Spring 繁體版
原文   原文链接

前言

一般咱们使用 Dockerfile 来构建项目的 Docker 镜像。可是也有使用 gradle 在编译项目的时候一块儿把镜像给 构建 并 上传 的需求。本文将会讲解如何使用 gradle 编写并配置 Dockerfile 并生成 镜像。java

本系列文章

  1. 实战Spring Boot 2.0系列(一) - 使用Gradle构建Docker镜像
  2. 实战Spring Boot 2.0系列(二) - 全局异常处理和测试
  3. 实战Spring Boot 2.0系列(三) - 使用@Async进行异步调用详解
  4. 实战Spring Boot 2.0系列(四) - 使用WebAsyncTask处理异步任务
  5. 实战Spring Boot 2.0系列(五) - Listener, Servlet, Filter和Interceptor
  6. 实战Spring Boot 2.0系列(六) - 单机定时任务的几种实现

正文

1. 建立项目

利用 Spring Initializer 建立一个 gradle 项目 spring-boot-gradle-for-docker，建立时添加一个 web 依赖。获得的初始 build.gradle 以下：git

buildscript {
    ext {
        springBootVersion = '2.0.2.RELEASE'
    }
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
    }
}

apply plugin: 'java'
apply plugin: 'org.springframework.boot'
apply plugin: 'io.spring.dependency-management'


group = 'io.ostenant.springboot.sample'
version = '1.0'
sourceCompatibility = 1.8

repositories {
    mavenCentral()
    jcenter()
}

dependencies {
    compile('org.springframework.boot:spring-boot-starter-web')
    testCompile('org.springframework.boot:spring-boot-starter-test')
}
复制代码

2. 配置入口类

为了方便容器部署的测试，在 Spring Boot 启动类上配置一个控制器，响应当前的系统时间。github

@RestController
@SpringBootApplication
public class Application {

    private ThreadLocal<SimpleDateFormat> threadLocal = ThreadLocal.withInitial(() -> new SimpleDateFormat("yyyy/MM/dd hh:mm:ss"));

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

    @GetMapping("/")
    public String retrieveTime() {
        return threadLocal.get().format(new Date());
    }
}
复制代码

3. 添加插件

这里使用 gradle-docker 插件 来实现 docker 镜像构建。这样，咱们就能够直接在 Gradle 的脚本里配置 Dockerfile 达到 构建镜像 功能的目的。web

gradle-docker 插件已经被上传到 jCenter 和 MavenCentral 上。因此只须要在 dependencies 添加依赖 se.transmode.gradle:gradle-docker:1.2 就能使用 docker 插件。spring

buildscript {
    ext {
        springBootVersion = '2.0.2.RELEASE'
    }
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
        classpath("se.transmode.gradle:gradle-docker:1.2")
    }
}
复制代码

4. 应用插件

添加如下代码到 build.gradle中docker

apply plugin: 'application'
apply plugin: 'docker'
复制代码

若是添加了 application 插件的话，默认 gradle-docker 插件会添加一个 distDocker 的 gradle task，用来构建一个 包含全部程序文件 的 docker 镜像。编程

5. 配置镜像构建信息

5.1. 配置group

group = 'io.ostenant.springboot.sample'
复制代码

5.2. 配置镜像名称和版本号

jar {
    baseName = "spring-boot-gradle-for-docker"
    version = 1.0
}
复制代码

其中镜像的 tag 默认的构成为：项目组/应用名称:版本号后端

tag = "${project.group}/${applicationName}:${tagVersion}"
复制代码

  • project.group：标准的 gradle 属性，若是不进行定义，插件默认会 省略 ${project.group} 这个属性。api

  • applicationName：应用被容器化时的 名称。缓存

  • tagVersion：可选属性，会做为镜像的 标签。默认值为 project.version，若是未指定 project.version，则使用 latest 做为标记。

5.3. 配置docker构建基础信息

distDocker {
    baseImage = "openjdk"
    maintainer = "harrison"
}
复制代码

其中，baseImage 至关于 Dockerfile 中声明的 FROM。声明了在 构建镜像 是基于的 Image，maintainer 至关于 MAINTAINER ，声明了 镜像做者。若是声明了 registry 地址，插件在 镜像射生成后 能够自动 push 到该地址。其余的配置还包括 docker hub 的 地址、用户名 和 密码。

更详细的配置案例以下：

docker {
    baseImage 'openjdk'
    maintainer 'harrison'
    useApi true
    hostUrl 'http://myserver:4243'
    apiUsername 'user'
    apiPassword 'password'
    apiEmail 'me@mycompany.com'
}
复制代码

6. 添加task任务

完成了基本的配置，咱们还须要添加一个 task 用来在 gradle 编译的时候 执行镜像构建。

插件提供了一些 转换方法，用来指代 Dockerfile 中的 关键词语法，以下表，能够按照需求对照着来：

Dockerfile关键词 gradle task方法
ADD addFile(Closure copySpec)
addFile(String source, String dest)
addFile(File source, String dest)
CMD defaultCommand(List cmd)
ENTRYPOINT entryPoint(List entryPoint)
ENV setEnvironment(String key, String val)
EXPOSE exposePort(Integer port)
exposePort(String port)
RUN runCommand(String cmd)
USER switchUser(String userNameOrUid)
VOLUME volume(String... paths)
WORKDIR workingDir(String dir)

下面是本项目的 taskBuilder 的任务配置

task dockerBuilder(type: Docker) {
    applicationName = jar.baseName
    tagVersion = jar.version
    volume('/tmp')
    addFile("${jar.baseName}-${jar.version}.jar", "app.jar")
    entryPoint(["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", 'app.jar'])
    exposePort(8080)
    doFirst {
        copy {
            from jar
            into stageDir
        }
    }
}
复制代码

构建完成y之后，项目根目录的 build/docker 文件夹下面会出现 Dockerfile 和 spring-boot-gradle-for-docker-1.0.jar 文件。其中，以上的 task 等同于如下的 Dockerfile。

FROM aglover/java8-pier
VOLUME ["/tmp"] ADD spring-boot-gradle-for-docker-1.0.jar app.jar ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", "app.jar"] EXPOSE 8080
复制代码

若是觉的在 task 中编写 Dockerfile 替换脚本 很是别扭，也能够直接在 task 中指定 Dockfile 的 文件路径，直接使用已有的文件来生成镜像：

task buildDocker(type: Docker) {
    applicationName = jar.baseName
    tagVersion = jar.version
    dockerfile = file('Dockerfile')
    doFirst {
        copy {             from jar
            into stageDir
        }
    }
}
复制代码

经过 file() 指定 task 使用位于 项目根目录 的 Dockerfile 来生产镜像。

7. 编译并构建Docker镜像

进入项目根目录，运行 gradle 命令进行打包构建。

$ ./gradlew clean build dockerBuilder --info
复制代码

gradle 首先会运行 本地测试，而后进行 项目打包，进一步根据 docker-gradle 插件进行 镜像构建。

等待出现 BUILD SUCCESSFUL 就代表任务运行成功。能够观察到镜像的名称为

io.ostenant.springboot.sample/spring-boot-gradle-for-docker:1.0
复制代码

运行 docker images 查看本地镜像，进一步验证镜像构建成功。

下面给出 build.gradle 完整的 配置文件

buildscript {
    ext {
        springBootVersion = '2.0.2.RELEASE'
    }
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
        classpath("se.transmode.gradle:gradle-docker:1.2")
    }
}

apply plugin: 'java'
apply plugin: 'org.springframework.boot'
apply plugin: 'io.spring.dependency-management'
apply plugin: 'application'
apply plugin: 'docker'


group = 'io.ostenant.springboot.sample'
version = '1.0'
sourceCompatibility = 1.8
targetCompatibility = 1.8
mainClassName = "io.ostenant.springboot.sample.Application"

repositories {
    mavenCentral()
    jcenter()
}

dependencies {
    compile('org.springframework.boot:spring-boot-starter-web')
    testCompile('org.springframework.boot:spring-boot-starter-test')
}

jar {
    baseName 'spring-boot-gradle-for-docker'
    version '1.0'
}

distDocker {
    baseImage 'openjdk'
    maintainer 'harrison'
}

task dockerBuilder(type: Docker) {
    applicationName = jar.baseName
    tagVersion = jar.version
    volume('/tmp')
    addFile("${jar.baseName}-${jar.version}.jar", "app.jar")
    entryPoint(["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", 'app.jar'])
    exposePort(8080)
    doFirst {
        copy {
            from jar
            into stageDir
        }
    }
}
复制代码

8. 使用镜像启动容器

运行以下命令，根据镜像启动容器，对外暴露 8080 访问端口。

$ docker run -d --name gradle-boot -p 8080:8080 io.ostenant.springboot.sample/spring-boot-gradle-for-docker:1.0
复制代码

访问 http://127.0.0.1:8080/ ，页面会输出当前系统时间，如图所示：

小结

gradle-docker 插件还提供了配置 镜像仓库地址、配置使用 Docker Remote Api 和 Docker Hub 等用法，能够参考该项目的 GitHub 地址来进行配置使用： github.com/Transmode/g…。

欢迎关注技术公众号： 零壹技术栈

零壹技术栈

本账号将持续分享后端技术干货，包括虚拟机基础，多线程编程，高性能框架，异步、缓存和消息中间件，分布式和微服务，架构学习和进阶等学习资料和文章。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程