Dubbo AOT -- 如何使用 GraalVM Native Image 实现 Dubbo 应用静态化

Mon, 01 Jan 0001 00:00:00 +0000

在 Dubbo 3.3.0 版本中，我们正式发布了 Dubbo AOT 静态化解决方案。本文档将介绍将介绍如何借助 Dubbo AOT 技术将应用接入 GraalVM Native Image，将应用编译为 Native 二进制包的流程以及目前支持的组件。

Dubbo GraalVM 适配文档可能更新滞后

由于 Dubbo AOT 技术发展迅速，本文档内容可能无法总是保持及时更新，请结合以下内容了解最新内容与使用方式：

关于 GraalVm 的更多信息可以阅读 https://www.graalvm.org/docs/getting-started/container-images/ 此文档。

使用场景

本机映像编译：将应用程序预编译为本机映像，缩短启动时间并减少内存使用。
语言互操作：GraalVM 能够用多种语言编写代码，在同一应用程序中进行互操作。
优化：GraalVM 为用 Java、JavaScript 和其他语言编写的应用程序提供优化，提高 Dubbo 应用程序的性能。
Polyglot 调试：GraalVM 能够在同一会话中调试用多种语言编写的代码，对复杂 Dubbo 应用程序中的问题进行故障排除时非常有用。
Java 运行时：可以在 GraalVM 上运行，提供更快、更高效的 Java 运行时环境。
开发微服务：可以与 GraalVM 结合，创建高性能、低资源利用率的微服务。

使用方式

在编译我们的dubbo项目之前，需要确保我们正基于graalVm的环境。

第一步：安装GraalVM

在Graalvm官网根据自己的系统选取对应Graalvm版本：https://www.graalvm.org/downloads/
根据官方文档安装native-image：https://www.graalvm.org/latest/reference-manual/native-image/#install-native-image

第二步：配置profiles

其中包括maven-compiler-plugin、spring-boot-maven-plugin、native-maven-plugin、dubbo-maven-plugin，修改dubbo-maven-plugin中的mainClass为所需的启动类全路径。（其中API使用方式无需添加spring-boot-maven-plugin依赖。）

 <profiles>
 <profile>
 <id>native</id>
 <build>
 <plugins>
 <plugin>
 <artifactId>maven-compiler-plugin</artifactId>
 <configuration>
 <release>17</release>
 <fork>true</fork>
 <verbose>true</verbose>
 </configuration>
 </plugin>
 <plugin>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-maven-plugin</artifactId>
 <executions>
 <execution>
 <id>process-aot</id>
 <goals>
 <goal>process-aot</goal>
 </goals>
 </execution>
 </executions>
 </plugin>
 <plugin>
 <groupId>org.graalvm.buildtools</groupId>
 <artifactId>native-maven-plugin</artifactId>
 <version>0.9.25</version>
 <configuration>
 <classesDirectory>${project.build.outputDirectory}</classesDirectory>
 <metadataRepository>
 <enabled>true</enabled>
 </metadataRepository>
 <requiredVersion>22.3</requiredVersion>
 </configuration>
 <executions>
 <execution>
 <id>add-reachability-metadata</id>
 <goals>
 <goal>add-reachability-metadata</goal>
 </goals>
 </execution>
 </executions>
 </plugin>
 <plugin>
 <groupId>org.apache.dubbo</groupId>
 <artifactId>dubbo-maven-plugin</artifactId>
 <version>${dubbo.version}</version>
 <configuration>
 <mainClass>com.example.nativedemo.NativeDemoApplication</mainClass>
 </configuration>
 <executions>
 <execution>
 <phase>process-sources</phase>
 <goals>
 <goal>dubbo-process-aot</goal>
 </goals>
 </execution>
 </executions>
 </plugin>
 </plugins>
 </build>
 </profile>
 </profiles>

第三步：在Pom依赖中添加native相关的依赖：

其中API使用方式无需添加dubbo-config-spring6依赖。