Quarkus+Docker最全面完整教程:手把手搞定Java云原生

一、Java如何实现云原生应用?

传统的 Java 框架(如 Spring Boot)虽然功能强大,但在云原生场景下可能显得笨重。以下是一些更适合云原生的轻量级框架:

Quarkus(推荐)

  • 专为云原生和 Kubernetes 设计的 Java 框架。
  • 支持 GraalVM 原生镜像,启动速度快,内存占用低。
  • 与 Kubernetes、OpenShift 等云原生平台深度集成。

Micronaut

  • 另一个轻量级框架,专注于快速启动和低内存占用。
  • 支持 GraalVM 原生镜像。
  • 提供了对微服务、函数计算和云原生环境的支持。

二、Java 云原生实战

接下来,我们将从零开始,开发一个简单的Java云原生应用,并将其打包发布到本地Docker。

环境准备

  • 操作系统:Windows 11
  • 开发工具:IntelliJ IDEA
  • 框架:Quarkus
  • 容器工具:Docker Desktop for Windows

步骤 1:创建Quarkus项目

  1. 打开IntelliJ IDEA,点击"New Project"。
  2. 选择"Quarkus"作为项目类型,点击"Next"。
  3. 输入项目名称(例如quarkus-demo-mvn),选择项目路径,点击"Create"。
  4. 在依赖选择页面,勾选"REST"",点击"Finish"。

完成后可以看到目录结构如下,除了多了个 docker 目录其它和 springboot 是一样的。

后面会具体介绍 docker 目录下几个文件的区别。

步骤 2:编写代码

  1. src/main/java目录下,找到自动生成的ExampleResource.java文件。
  2. 修改代码如下:
kotlin 复制代码
package com.hanko;

import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.MediaType;

@Path("/hello")
public class ExampleResource {

    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String hello() {
        return "Hello from Quarkus REST";
    }
}

可以看到代码和我们以前不一样的地方就是:

  • 没有引用 spring 相关依赖
  • 注解使用的与 springboot 不一样
  • 可以看到它引用的都是 jakarta.ws.rs 的依赖也就是JAX-RS(Java API for RESTful Web Services)它是 Java 中用于开发和实现 RESTful Web 服务 的标准 API。它是 Jakarta EE(原 Java EE)的一部分,提供了一套基于注解的编程模型,使得开发者可以轻松地将 Java 类暴露为 RESTful 资源。
  • quarkus 项目没有 SpringBootApplication 注解的启动类

步骤 3:本地运行

  1. 一般 IDEA 创建的项目在 IDEA 最上面会有 quarkus logo 点击小三角就可以启动项目。
  2. 打开浏览器,访问http://localhost:8080/,你会看到页面显示"Hello, Quarkus!"。
  1. 点/hello 也就是我们代码中实现的 rest 服务

p.s. quarkus 项目还有个比较优秀的功能就是默认就支持热加载,我们修改代码后不需要像 springboot 项目一样手动重启才生效。

修改代码后,在浏览器访问服务时,到达代码时就会触发热加载,此次热加载启动只花了 0.429 秒。

关于启动这块,还有没有其它的启动方式呢?当然通过命令行或 maven 都是可以的,如

quarkus:dev

步骤 4:打包 quarkus 项目

一般打包为 quarkus 项目要分成使用本地 GraalVM 与不使用本地 GraalVM

  • 使用本地GraalVM
bash 复制代码
./mvnw package -Dnative
#mvn或mvnw都可以打包,使用mvnw还需要执行mvn wrapper:wrapper安装

这种比较麻烦的就是安装GraalVM 与Visual Studio。

GraalVM 的 native-image 工具依赖于 Visual Studio 的 C++ 编译器 (cl.exe) 和相关的构建工具。

就是还需要安装这些,安装完还需要配置 include、lib 环境变量。

  • 不使用本地GraalVM

Quarkus 会在 Docker 容器内完成所有操作

这种方式就简单多了,把本地可远程 docker 启动后,在 idea 里配置好

通过命令行

ini 复制代码
./mvnw package -Dquarkus.container-image.build=true

如果你不想用命令行的话也可以选择使用 idea 来打包,就是直接使用生命周期中的 package

至于-Dquarkus.container-image.build=true 这个参数就可以放到项目中的 pom.xml 中去

pom.xml

xml 复制代码
<properties>
    <skipITs>true</skipITs>
    <quarkus.native.container-build>true</quarkus.native.container-build>
    <quarkus.native.enabled>true</quarkus.native.enabled>
</properties>

就可以直接打包好了

可以看到我已经打包完成,就是这个文件。看到这个 xx-runner 文件就说明已经成功了

步骤 5:生成Docker镜像

这时就要使用项目中的几个 dockerfile 文件

  • Dockerfile.jvm 适合传统的 Java 应用,兼容性好,构建速度快。
  • Dockerfile.native 适合云原生场景,启动速度快,内存占用低。
  • Dockerfile.native-microDockerfile.native 的基础上进一步优化了镜像大小和安全性,适合对容器化部署有更高要求的场景。

p.s. 这几个文件中的配置是直接 copy target 目录文件,所以我们要把 docker 目录中的这几个文件先拷贝到项目的根目录下,如上图。

打镜像时,直接在文件上右键运行就可以了,当然你也可以修改一下配置,比如给镜像增加个名称

这就是三个 Dockerfile 配置文件对应生成的 docker 镜像文件

可以看到传统的大小为 413M,而原生的可以达到 79M,缩小 5 倍多。之前很多人抱怨 springboot 太大,打成 docker 就更大了,这回 quarkus 成为你们的福音了。

我们再来启动 demo-native-micro 镜像试试,点击小三角后,展开设置界面设置个宿主机的端口

已经启动了

访问方式,应用正常

到这里就完成了。

通过这个教程,我们从零开始创建了一个简单的Java云原生应用,并将其打包发布到本地Docker。整个过程非常简单,但涵盖了云原生开发的核心步骤:选择轻量级框架、编写代码、容器化部署。

我是栈江湖,如果你喜欢此文章,不要忘记点赞+关注

相关推荐
.生产的驴2 分钟前
SpringBoot 封装统一API返回格式对象 标准化开发 请求封装 统一格式处理
java·数据库·spring boot·后端·spring·eclipse·maven
景天科技苑11 分钟前
【Rust】Rust中的枚举与模式匹配,原理解析与应用实战
开发语言·后端·rust·match·enum·枚举与模式匹配·rust枚举与模式匹配
matrixlzp20 分钟前
K8S Service 原理、案例
云原生·容器·kubernetes
追逐时光者1 小时前
MongoDB从入门到实战之Docker快速安装MongoDB
后端·mongodb
方圆想当图灵1 小时前
深入理解 AOP:使用 AspectJ 实现对 Maven 依赖中 Jar 包类的织入
后端·maven
豌豆花下猫1 小时前
Python 潮流周刊#99:如何在生产环境中运行 Python?(摘要)
后端·python·ai
嘻嘻嘻嘻嘻嘻ys1 小时前
《Spring Boot 3 + Java 17:响应式云原生架构深度实践与范式革新》
前端·后端
异常君1 小时前
线程池隐患解析:为何阿里巴巴拒绝 Executors
java·后端·代码规范
GnixAij1 小时前
Docker SSH端口转发
docker·ssh
mazhimazhi1 小时前
GC垃圾收集时,居然还有用户线程在奔跑
后端·面试