Build GraalVM Native Image(Alpha)

    • ShardingSphere Proxy is not yet ready to integrate with GraalVM Native Image. It has daily build tasks at https://github.com/apache/shardingsphere/actions/ for testing builds.

    • If you find that the build process has missing GraalVM Reachability Metadata, A new issue should be opened at And submit a PR containing GraalVM Reachability Metadata missing from ShardingSphere itself or dependent third-party libraries.

    • The master branch of ShardingSphere is not yet ready to handle unit tests in Native Image, Need to wait for the integration of Junit 5 Platform, you always need to build GraalVM Native Image in the process, Plus -DskipNativeTests or -DskipTests parameter specific to GraalVM Native Build Tools to skip unit tests in Native Image.

    1. Install and configure GraalVM CE or GraalVM EE for JDK 17 according to . GraalVM CE for JDK 17 can also be installed via SDKMAN!.

    2. Install the native-image component via the GraalVM Updater tool.

    3. Install the local toolchain as required by https://www.graalvm.org/22.2/reference-manual/native-image/#prerequisites.

    1. Get Apache ShardingSphere Git Source
    1. Build the product on the command line, in two cases.

    • Execute the following command in the same directory of Git Source to directly complete the construction of Native Image.

    • Scenario 2: It is necessary to use a JAR that has an SPI implementation or a third-party dependent JAR of a LICENSE such as GPL V2.

    2. <dependencies>
    3.     <dependency>
    5.         <artifactId>mysql-connector-java</artifactId>
    6.         <version>8.0.30</version>
    7.     </dependency>
    8.     <dependency>
    9.         <groupId>org.apache.shardingsphere</groupId>
    10.         <artifactId>shardingsphere-sql-translator-jooq-provider</artifactId>
    11.         <version>5.2.0</version>
    12.     </dependency>
    • Build GraalVM Native Image via command line.
    1. Start Native Image through the command line, you need to bring two parameters, The first parameter is the port used by ShardingSphere Proxy, and the second parameter is the /conf folder that contains server.yaml written by you, Assuming the folder ./custom/conf already exists, the example is
    1. ./apache-shardingsphere-proxy 3307 ./custom/conf
    1. If you need to build a Docker Image, after adding the dependencies of the SPI implementation or third-party dependencies, execute the following commands on the command line.
    • Assuming that there is a conf folder containing server.yaml as ./custom/conf, you can start the Docker Image corresponding to GraalVM Native Image through the following docker-compose.yml file.
    1. version: "3.8"
    3. services:
    4.   apache-shardingsphere-proxy-native:
    5.     image: apache/shardingsphere-proxy-native:latest
    6.     volumes:
    7.       - ./custom/conf:/conf
    8.     ports:
    9.       - "3307:3307"
    • If you use the default build configuration, you can of course use scratch as the base docker image for shardingsphere-distribution/shardingsphere-proxy-native-distribution/Dockerfile. But if you actively add jvmArgs to -H:+StaticExecutableWithDynamicLibC for the native profile of pom.xml, To statically link everything except glic, you should switch the base image to busybox:glic. Refer to https://www.graalvm.org/22.2/reference-manual/native-image/guides/build-static-executables/. Also note that some third-party dependencies will require more system libraries, such as libdl. So make sure to adjust the base docker image and the content of pom.xml and Dockerfile under according to your usage.