专栏首页TECH flower云原生时代高性能Java框架—Quarkus(二)

云原生时代高性能Java框架—Quarkus(二)

——— 构建Quarkus本地镜像、容器化部署Quarkus项目


Quarkus系列博文

  • Quarkus&GraalVM介绍、创建并启动第一个项目
  • 构建Quarkus本地镜像、容器化部署Quarkus项目
  • ...

概览

上一篇文章主要介绍了Quarkus以及给Quarkus提供“神力”的Java虚拟机GraalVM,并演示了如何安装GraalVM以及Quarkus的初步用法。本文将主要指向Quarkus的“亮点”——本地化应用程序。

以下是本文的两个目标:

  • 将Quarkus开发的Java应用程序编译成本地可执行文件。
  • 将本地可执行文件打包到容器中。

注:在本文中本地可执行文件又称本地镜像,二者意思相同。

环境准备

以下为本文所演示时的环境配置

  • Intellij IDEA
  • Maven
  • GraalVM 20.1.0
  • Docker

接下来需要安装GraalVM的一个扩展——“native-image“,此扩展用于将Java程序编译成本地可执行文件,我们执行以下命令:

gu install native-image

运行以下命令,查看扩展是否已安装:

$ native-image --version

生成本地可执行文件

生成本地可执行文件的步骤如下图:

IDEA打开上一篇文章创建的项目,并打开控制台,执行maven命令:

./mvnw package -Pnative

控制台输出以下内容:

[INFO] Scanning for projects...
...
[INFO] Building untitled 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 
...
[INFO] -------------------------------------------------------
[INFO]  T E S T S
[INFO] -------------------------------------------------------
[INFO] Running com.example.ExampleResourceTest
2020-07-19 22:24:08,962 INFO  [io.quarkus] (main) Quarkus 1.6.0.Final on JVM started in 1.085s. Listening on: http://0.0.0.0:8081
...
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] 
...
[INFO] [io.quarkus.deployment.pkg.steps.NativeImageBuildStep] Running Quarkus native-image plugin on GraalVM Version 20.1.0 (Java Version 11.0.7)
...
[INFO] [io.quarkus.deployment.QuarkusAugmentor] Quarkus augmentation completed in 93802ms
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:45 min
[INFO] Finished at: 2020-07-19T22:25:44+08:00
[INFO] ------------------------------------------------------------------------

打开项目中的target文件夹

可以看到其中有个重要的文件:XXX-runner,它是一个对JVM不依赖的本地可执行文件,我们可以运行他来启动应用程序。

$ ./target/untitled-1.0-SNAPSHOT-runner

成功启动应用程序,并且启动速度非常快?!

对比

在这里我们可以对比本地可执行文件与传统基于jvm启动速度的对比

运行如下命令,生成传统应用程序的jar文件:

./mvnw package

分别运行本地可执行文件和jar文件:

速度差异非常的悬殊!

相关配置

打开项目根目录的pom.xml,可以看到如下配置:

<profiles>
    <profile>
        <id>native</id>
        <properties>
            <quarkus.package.type>native</quarkus.package.type>
        </properties>
    </profile>
</profiles>

我们可以在id为native的profile中配置具体的配置项参数来自定义本地镜像(本地可执行文件)的生成。

如下为quarkus提供的具体配置列表:

Quarkus提供了许多生成本地镜像(native-image即本地可执行文件)的配置项,点击查看(可左右滑动)。


容器化本地可执行文件

我们可以很轻松的将Java应用程序的jar包进行容器化,当然我们也可以很轻松的将上一步生成的本地可执行文件进行容器化。

容器化本地可执行文件的步骤如下:

容器化本地可执行文件

添加配置

我们要将生成的本地可执行文件进行容器化,所以需要考虑到本地可执行文件对环境的兼容问题,在这里所生成的本地可执行文件的格式应该和docker镜像中的环境兼容了,而不是我们的本机环境(MacOS,Linux,Windows等等)。因为不同的操作系统支持的本地可执行文件的格式并不一样,quarkus在生成本地可执行文件的时候会根据不同的操作系统环境而选择不同的可执行文件格式。

首先我们在项目的src/main/resources/application.properties文件中添加配置:

quarkus.native.container-runtime=docker

上面配置表明在容器化本地可执行文件时将基于docker环境,我们也可以基于其他的容器环境,比如podman。

执行以下命令生成兼容docker容器环境的本地可执行文件:

./mvnw package -Pnative -Dquarkus.native.container-build=true

执行以下命令,将本地可执行文件打包成docker镜像:

docker build -f src/main/docker/Dockerfile.native -t quarkus-quickstart/getting-started .

生成完毕,运行以下命令即可启动该容器:

docker run -i --rm -p 8080:8080 quarkus-quickstart/getting-started

可以看到通过容器方式启动应用程序速度也很快

我们可以看一下这背后的Dockerfile,打开src/main/docker/Dockerfile.native

FROM registry.access.redhat.com/ubi8/ubi-minimal:8.1
WORKDIR /work/
RUN chown 1001 /work \
    && chmod "g+rwX" /work \
    && chown 1001:root /work
COPY --chown=1001:root target/*-runner /work/application

EXPOSE 8080
USER 1001

CMD ["./application", "-Dquarkus.http.host=0.0.0.0"]

Quarkus使用ubi-minimal镜像作为容器的基础镜像,它是一个通用基本镜像,Dockerfiles使用基本镜像的最小版本来减小生成的镜像的大小。

无GraalVM环境下的镜像生成

当我们处理一个CI/CD的环境或其他本地无GraalVM的环境时,此时就不能在本地生成本地可执行文件了。我们可以通过在docker中处理这些操作,在项目的src/main/docker中添加文件Dockerfile.multistage,并在文件中添加下面内容:

## Stage 1 : build with maven builder image with native capabilities
FROM quay.io/quarkus/centos-quarkus-maven:20.1.0-java11 AS build
COPY pom.xml /usr/src/app/
RUN mvn -f /usr/src/app/pom.xml -B de.qaware.maven:go-offline-maven-plugin:1.2.5:resolve-dependencies
COPY src /usr/src/app/src
USER root
RUN chown -R quarkus /usr/src/app
USER quarkus
RUN mvn -f /usr/src/app/pom.xml -Pnative clean package

## Stage 2 : create the docker final image
FROM registry.access.redhat.com/ubi8/ubi-minimal
WORKDIR /work/
COPY --from=build /usr/src/app/target/*-runner /work/application

# set up permissions for user `1001`
RUN chmod 775 /work /work/application \
  && chown -R 1001 /work \
  && chmod -R "g+rwX" /work \
  && chown -R 1001:root /work

EXPOSE 8080
USER 1001

CMD ["./application", "-Dquarkus.http.host=0.0.0.0"]

这是一个多阶段的镜像打包过程,第一阶段我们在docekr中构建本地可执行文件,第二阶段再将本地可执行文件打包成镜像。

运行如下命令:

docker build -f src/main/docker/Dockerfile.multistage -t quarkus-quickstart/getting-started .

如上操作将两个阶段的操作整合在一起,并生成了最终的镜像。

运行如下命令启动容器:

docker run -i --rm -p 8080:8080 quarkus-quickstart/getting-started

测试本地可执行文件

打开项目中的测试文件夹,可以看到有如下两个件

其中ExampleResourceTest类为普通的Java测试类,他的运行基于JVM。

@QuarkusTest
public class ExampleResourceTest {

    @Test
    public void testHelloEndpoint() {
        given()
            .when().get("/hello")
            .then()
            .statusCode(200)
            .body(is("hello"));
    }

}

上述测试类使用了@QuarkusTest注解,这个注解类似于Spring Boot中的@SpringBootTest,用来在测试前启动上下文。

NativeExampleResourceIT则不同,该测试类的代码如下:

package com.example;

import io.quarkus.test.junit.NativeImageTest;

@NativeImageTest 1️⃣
public class NativeExampleResourceIT extends ExampleResourceTest 2️⃣{

    // Execute the same tests but in native mode.
}

1️⃣:@NativeImageTest 注解表示此测试类是一个基于本地镜像的测试类,在测试之前,从本地可执行文件启动应用程序。可执行文件位置可在Maven的pom.xml中配置(maven-failsafe-pluginnative.image.path属性)。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <version>${surefire-plugin.version}</version>
    <executions>
        <execution>
            <goals>
                <goal>integration-test</goal>
                <goal>verify</goal>
            </goals>
            <configuration>
                <systemPropertyVariables>
                    <native.image.path>${project.build.directory}/${project.build.finalName}-runner</native.image.path>
                    <java.util.logging.manager>org.jboss.logmanager.LogManager</java.util.logging.manager>
                    <maven.home>${maven.home}</maven.home>
                </systemPropertyVariables>
            </configuration>
        </execution>
    </executions>
</plugin>

2️⃣:这里的代码表示我们扩展了之前的测试,但是您也可以自定义实现您自己的测试。

运行本地镜像测试和普通测试的方式有差异,本地镜像测试需要使用Maven命令来启动,我们在IDEA控制台中运行./mvnw verify -Pnative即可启动本地镜像测试。注意:由于我们上一步中在项目的配置文件中添加了quarkus.native.container-runtime=docker,现在我们需要去掉,否则生成的可执行文件格式可能和你本机的格式不兼容。

[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------< com.example:untitled >------------------------
[INFO] -------------------------------------------------------
[INFO]  T E S T S
[INFO] -------------------------------------------------------
[INFO] Running com.example.NativeExampleResourceIT
Executing [/Users/chengang/IdeaProjects/quarkus-demo/target/untitled-1.0-SNAPSHOT-runner, -Dquarkus.http.port=8081, -Dquarkus.http.ssl-port=8444, -Dtest.url=http://localhost:8081, -Dquarkus.log.file.path=target/target/quarkus.log]
__  ____  __  _____   ___  __ ____  ______
 --/ __ \/ / / / _ | / _ \/ //_/ / / / __/
 -/ /_/ / /_/ / __ |/ , _/ ,< / /_/ /\ \
--\___\_\____/_/ |_/_/|_/_/|_|\____/___/
2020-07-23 22:21:09,626 INFO  [io.quarkus] (main) untitled 1.0-SNAPSHOT native (powered by Quarkus 1.6.0.Final) started in 0.019s. Listening on: http://0.0.0.0:8081
2020-07-23 22:21:09,626 INFO  [io.quarkus] (main) Profile prod activated.
2020-07-23 22:21:09,626 INFO  [io.quarkus] (main) Installed features: [cdi, resteasy]
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.3 s - in com.example.NativeExampleResourceIT
[INFO]
[INFO] Results:
[INFO]
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO]
[INFO]
[INFO] --- maven-failsafe-plugin:2.22.1:verify (default) @ untitled ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  02:17 min
[INFO] Finished at: 2020-07-23T22:21:11+08:00
[INFO] ------------------------------------------------------------------------
chengang@chengangdeMacBook-Pro quarkus-demo %

测试通过!

总结

本文主要介绍了Quarkus框架的本地化相关操作,我们具体介绍了如何将Quarkus项目编译成本地可执行文件,随后又演示了如何将生成的可执行文件打包成Docker镜像,最后我们演示了如何以本地可执行文件的形式测试业务代码。随着将Java应用程序编译成本地镜像,Java的性能优势有了极大的提升。

本文参考:https://quarkus.io/guides/building-native-image

本文分享自微信公众号 - TECH flower(tech-flower),作者:东溪陈姓少年

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2020-08-03

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • [译] 微服务的设计模式

    微服务架构已经成为现代应用程序开发中公认的技术选择。尽管它解决了某些问题,但不是灵丹妙药。它有几个缺点,使用这种体系架构时,还需要解决许多问题。这就需要学习这些...

    东溪陈姓少年
  • 聊聊Spring Boot Actuator

    在本文中,我们将介绍Spring Boot Actuator。我们将首先介绍基础知识,然后详细讨论Spring Boot 1.x和2.x中的可用内容。

    东溪陈姓少年
  • [译]谈谈SpringBoot 事件机制

    要“监听”事件,我们总是可以将“监听器”作为事件源中的另一个方法写入事件,但这将使事件源与监听器的逻辑紧密耦合。

    东溪陈姓少年
  • 分享一套SpringBoot开发博客系统源码,以及完整开发文档!速度保存!

    摘要:eblog是一个基于Springboot2.1.2开发的博客学习项目,为了让项目融合更多的知识点,达到学习目的,编写了详细的从0到1开发文档。主要学习包括...

    江南一点雨
  • 分享一套SpringBoot开发博客系统源码,以及完整开发文档!速度保存!

    摘要:eblog是一个基于Springboot2.1.2开发的博客学习项目,为了让项目融合更多的知识点,达到学习目的,编写了详细的从0到1开发文档。主要学习包括...

    乔戈里
  • Maven依赖机制

    mvn dependency:list:查看当前项目所有依赖。 mvn dependency:tree:以树的形式显示当前项目的所有依赖,相比mvn depe...

    布禾
  • 一晚上,搞出来一个微信订阅号鉴黄机器人

    公众号接收用户消息 -> 微信平台发送消息给我们的服务器 -> 我们的服务器处理消息 -> 返回处理结果给微信平台 -> 微信平台发送内容给用户。

    逆锋起笔
  • 探究Java虚拟机栈

    Java 虚拟机的内存模型分为两部分:一部分是线程共享的,包括 Java 堆和方法区;另一部分是线程私有的,包括虚拟机栈和本地方法栈,以及程序计数器这一小部分内...

    Java团长
  • gRPC简介

    该页面向您介绍gRPC和protocol buffers。 gRPC可以将protocol buffers用作其接口定义语言(IDL)和其基础消息交换格式。 如...

    ccf19881030
  • pycharm 教程(一)安装和首次使用 原

    PyCharm 是我用过的python编辑器中,比较顺手的一个。而且可以跨平台,在macos和windows下面都可以用,这点比较好。

    拓荒者

扫码关注云+社区

领取腾讯云代金券