This is an automated email from the ASF dual-hosted git repository.
liujun pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/master by this push:
new b6f9934 添加dubbo3.0支持graalvm文档（英文） (#866)
b6f9934 is described below
commit b6f99341d5afb4635d053c0f4ffa9b87abe785d8
Author: Wei Zhou <[email protected]>
AuthorDate: Fri Jul 16 15:06:29 2021 +0800
添加dubbo3.0支持graalvm文档（英文） (#866)
---
content/en/docs/v3.0/references/graalvm/_index.md | 7 +
.../v3.0/references/graalvm/support-graalvm.md | 152 +++++++++++++++++++++
2 files changed, 159 insertions(+)
diff --git a/content/en/docs/v3.0/references/graalvm/_index.md
b/content/en/docs/v3.0/references/graalvm/_index.md
new file mode 100644
index 0000000..269e856
--- /dev/null
+++ b/content/en/docs/v3.0/references/graalvm/_index.md
@@ -0,0 +1,7 @@
+---
+type: docs
+title: "graalvm support"
+linkTitle: "support graalvm"
+weight: 40
+description: ""
+---
diff --git a/content/en/docs/v3.0/references/graalvm/support-graalvm.md
b/content/en/docs/v3.0/references/graalvm/support-graalvm.md
new file mode 100644
index 0000000..01e4027
--- /dev/null
+++ b/content/en/docs/v3.0/references/graalvm/support-graalvm.md
@@ -0,0 +1,152 @@
+## Overview
+
+This document will show you how to access GraalVM with a dubbo project and how
to compile the project to a binary executable using native-image.
+
+For more information about GraalVM, read
https://www.graalvm.org/docs/getting-started/container-images/.
+
+## Demo
+
+Before compiling the dubbo project, make sure that we are programming based on
the GraalVM environment.
+
+1. Install GraalVM
+
+ Visite the official website (https://www.graalvm.org/ ) and install the
latest version based on your system:
+
+
+
+ After installation, configure the path of JAVA_HOME. You should see thr
following in your local jdk after this step:
+
+
+
+ GraalVM we use here is based on jdk version 1.8.
+ To install native-image, run 'gu install native-image'.
+
+2. Pull dubbo code and switch to branch
[apache:3.0](https://github.com/apache/dubbo).
+
+3. Manually generate SPI code
+
+ Currently native-image compiling does not support dynamic code generation.
Therefore we need to first manually generate the part of the code that is
generated dynamically. The tool function is provided here:
+
+
+
+ Execute CodeGenerator can generate SPI code under the dubbo-native module.
+
+4. Execute 'install' under the root directory
+
+ ```ruby
+ MacdeMacBook-pro-3:incubator-dubbo mac$ pwd
+ /Users/mac/Documents/Mi/project/incubator-dubbo
+ MacdeMacBook-pro-3:incubator-dubbo mac$ mvn clean package install
-Dmaven.test.skip=true
+ ```
+
+5. Compile the project demo
+
+ Here we provide a demo project that can be directly compiled: dubbo-demo /
dubbo-demo-native. After installation, first go to the provider in
dubbo-demo-native and execute native-image compilation:
+
+ ```java
+ mvn clean package -P native -Dmaven.test.skip=true
+ ```
+
+ Since we have imported native-image plugin in maven, here we can use '-P
native' to execute the plugin.
+
+
+
+ After a success compilation, we can find the generated binary file under
target. Succefully iniate a zookeeper locally and execute the binary executable
file should show us this:
+
+
+
+ Compile on consumer' side will generate a binary executable file
'demo-native-consumer' under consumer's target. Execute the file will give us
the following output:
+
+
+
+### Additional Steps
+
+In this demo, we did extra work to make sure the project can be compiled. Here
are the additional steps:
+
+- Import dependency dubbo-native
+
+ ```html
+ <dependency>
+ <groupId>org.apache.dubbo</groupId>
+ <artifactId>dubbo-native</artifactId>
+ <version>${project.version}</version>
+ </dependency>
+ ```
+
+ Our generated SPI code is in this module.
+
+- Import native-image plug-in
+
+ ```Lua
+ <plugin>
+ <groupId>org.graalvm.nativeimage</groupId>
+ <artifactId>native-image-maven-plugin</artifactId>
+ <version>21.0.0.2</version>
+ <executions>
+ <execution>
+ <goals>
+ <goal>native-image</goal>
+ </goals>
+ <phase>package</phase>
+ </execution>
+ </executions>
+ <configuration>
+ <skip>false</skip>
+ <imageName>demo-native-provider</imageName>
+
<mainClass>org.apache.dubbo.demo.graalvm.provider.Application</mainClass>
+ <buildArgs>
+ --no-fallback
+ --initialize-at-build-time=org.slf4j.MDC
+ --initialize-at-build-time=org.slf4j.LoggerFactory
+ --initialize-at-build-time=org.slf4j.impl.StaticLoggerBinder
+ --initialize-at-build-time=org.apache.log4j.helpers.Loader
+ --initialize-at-build-time=org.apache.log4j.Logger
+ --initialize-at-build-time=org.apache.log4j.helpers.LogLog
+ --initialize-at-build-time=org.apache.log4j.LogManager
+ --initialize-at-build-time=org.apache.log4j.spi.LoggingEvent
+ --initialize-at-build-time=org.slf4j.impl.Log4jLoggerFactory
+ --initialize-at-build-time=org.slf4j.impl.Log4jLoggerAdapter
+
--initialize-at-build-time=org.eclipse.collections.api.factory.Sets
+ --initialize-at-run-time=io.netty.channel.epoll.Epoll
+ --initialize-at-run-time=io.netty.channel.epoll.Native
+ --initialize-at-run-time=io.netty.channel.epoll.EpollEventLoop
+ --initialize-at-run-time=io.netty.channel.epoll.EpollEventArray
+ --initialize-at-run-time=io.netty.channel.DefaultFileRegion
+ --initialize-at-run-time=io.netty.channel.kqueue.KQueueEventArray
+ --initialize-at-run-time=io.netty.channel.kqueue.KQueueEventLoop
+ --initialize-at-run-time=io.netty.channel.kqueue.Native
+ --initialize-at-run-time=io.netty.channel.unix.Errors
+ --initialize-at-run-time=io.netty.channel.unix.IovArray
+ --initialize-at-run-time=io.netty.channel.unix.Limits
+
--initialize-at-run-time=io.netty.util.internal.logging.Log4JLogger
+ --initialize-at-run-time=io.netty.channel.unix.Socket
+ --initialize-at-run-time=io.netty.channel.ChannelHandlerMask
+
+ --report-unsupported-elements-at-runtime
+ --allow-incomplete-classpath
+ --enable-url-protocols=http
+ -H:+ReportExceptionStackTraces
+ </buildArgs>
+ </configuration>
+ </plugin>
+ ```
+
+ Generated image names and parameters used for generating image are defined.
+
+- Mount native-image-agent
+
+ Since some classes, including reflection and JNI, need to be assigned, we
have to use the agent to run the json information that generate these classes.
+
+ Add the following to startup parameters:
+
+ ```xml
+
-agentlib:native-image-agent=config-output-dir=/tmp/config/,config-write-period-secs=300,config-write-initial-delay-secs=5
+ ```
+
+ Launch in conventional way, create folder 'META-INF.native-image' under the
resources folder and paste the generated files in the local directory into the
folder.
+
+
+
+ (Missing classes' information may exist. These information need to be
manually added according to the error message reported while compiling or
running.)
+
+ **Finished the steps above, now you can compile your project.**
