feat(clustertest): add basic MiniCluster module for distributed system

hugegraph-cluster-test/hg-ct-dist/pom.xml

@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to You under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~     http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.apache.hugegraph</groupId>
+        <artifactId>hugegraph-cluster-test</artifactId>
+        <version>${revision}</version>
+        <relativePath>../pom.xml</relativePath>
+    </parent>
+
+    <artifactId>hg-ct-dist</artifactId>
+
+    <properties>
+        <dist.dir>${project.parent.basedir}</dist.dir>
+        <shell-executable>bash</shell-executable>
+        <assembly.dir>${project.basedir}/src/assembly</assembly.dir>
+        <assembly.descriptor.dir>${assembly.dir}/descriptor</assembly.descriptor.dir>
+        <assembly.static.dir>${assembly.dir}/static</assembly.static.dir>
+        <executable.jar.name>hg-ct</executable.jar.name>
+    </properties>
+
+    <build>
+        <plugins>
+            <plugin>
+                <artifactId>maven-assembly-plugin</artifactId>
+                <version>2.4</version>
+                <executions>
+                    <execution>
+                        <id>assembly-hugegraph-ct</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>single</goal>
+                        </goals>
+                        <configuration>
+                            <attach>false</attach>
+                            <appendAssemblyId>false</appendAssemblyId>
+                            <outputDirectory>${dist.dir}</outputDirectory>
+                            <descriptors>
+                                <descriptor>
+                                    ${assembly.descriptor.dir}/assembly.xml
+                                </descriptor>
+                            </descriptors>
+                            <finalName>${final.name}</finalName>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.hugegraph</groupId>
+            <artifactId>hg-ct-minicluster</artifactId>
+            <version>${revision}</version>
+        </dependency>
+    </dependencies>
+
+</project>

hugegraph-cluster-test/hg-ct-dist/src/assembly/descriptor/assembly.xml

@@ -0,0 +1,64 @@
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to You under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~     http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+<assembly>
+    <id>distribution</id>
+    <includeBaseDirectory>false</includeBaseDirectory>
+
+    <formats>
+        <format>dir</format>
+    </formats>
+
+    <fileSets>
+        <!--        <fileSet>-->
+        <!--            <directory>${assembly.static.dir}/bin</directory>-->
+        <!--            <outputDirectory>bin</outputDirectory>-->
+        <!--            <includes>-->
+        <!--                <include>*</include>-->
+        <!--            </includes>-->
+        <!--            <fileMode>755</fileMode>-->
+        <!--        </fileSet>-->
+        <fileSet>
+            <directory>${assembly.static.dir}/simple</directory>
+            <outputDirectory>simple</outputDirectory>
+            <includes>
+                <include>**/*</include>
+            </includes>
+        </fileSet>
+        <fileSet>
+            <directory>${assembly.static.dir}/multi</directory>
+            <outputDirectory>multi</outputDirectory>
+            <includes>
+                <include>**/*</include>
+            </includes>
+        </fileSet>
+    </fileSets>
+
+    <dependencySets>
+        <!-- code jars -->
+        <dependencySet>
+            <outputDirectory>/lib</outputDirectory>
+            <unpack>false</unpack>
+            <scope>runtime</scope>
+            <useProjectArtifact>false</useProjectArtifact>
+            <includes>
+                <include>org.apache.hugegraph:${executable.jar.name}:jar:*</include>
+            </includes>
+        </dependencySet>
+    </dependencySets>
+
+</assembly>

hugegraph-cluster-test/hg-ct-minicluster/pom.xml

@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to You under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~     http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>hg-ct-minicluster</artifactId>
+
+    <parent>
+        <groupId>org.apache.hugegraph</groupId>
+        <artifactId>hugegraph-cluster-test</artifactId>
+        <version>${revision}</version>
+    </parent>
+
+
+    <properties>
+        <maven.compiler.source>11</maven.compiler.source>
+        <maven.compiler.target>11</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <log4j2.version>2.17.0</log4j2.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.commons</groupId>
+            <artifactId>commons-lang3</artifactId>
+            <version>3.13.0</version>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>commons-io</groupId>
+            <artifactId>commons-io</artifactId>
+            <version>2.12.0</version>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.slf4j</groupId>
+            <artifactId>slf4j-api</artifactId>
+            <version>2.0.9</version>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <version>1.18.24</version>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.freemarker</groupId>
+            <artifactId>freemarker</artifactId>
+            <version>2.3.33</version>
+        </dependency>
+        <dependency>
+            <groupId>org.yaml</groupId>
+            <artifactId>snakeyaml</artifactId>
+            <version>2.2</version>
+            <scope>compile</scope>
+        </dependency>
+    </dependencies>
+
+</project>

hugegraph-cluster-test/hg-ct-minicluster/src/main/java/org/apache/hugegraph/ct/base/ClusterConstant.java

@@ -0,0 +1,142 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.hugegraph.ct.base;
+
+import java.io.File;
+
+import org.apache.commons.lang3.SystemUtils;
+
+public class ClusterConstant {
+
+    public static final String USER_DIR = "user.dir";
+    public static final String LOG = "logs";
+
+    public static final String LIB_DIR = "lib";
+    public static final String EXT_DIR = "ext";
+    public static final String PLUGINS_DIR = "plugins";
+    public static final String BIN_DIR = "bin";
+    public static final String DIST_DIR = "dist";
+    public static final String CONF_DIR = "conf";
+
+    public static final String PD_PACKAGE_PREFIX = "hugegraph-pd";
+    public static final String PD_JAR_PREFIX = "hg-pd-service";
+    public static final String STORE_PACKAGE_PREFIX = "hugegraph-store";
+    public static final String STORE_JAR_PREFIX = "hg-store-node";
+    public static final String SERVER_PACKAGE_PREFIX = "apache-hugegraph-incubating";
+    public static final String CT_PACKAGE_PREFIX = "apache-hugegraph-incubating-ct";
+
+    public static final String APPLICATION_FILE = "application.yml";
+    public static final String SERVER_PROPERTIES = "rest-server.properties";
+    public static final String HUGEGRAPH_PROPERTIES = "hugegraph.properties";
+    public static final String LOG4J_FILE = "log4j2.xml";
+    public static final String VERIFY_LICENSE_FILE = "verify-license.json";
+    public static final String LICENSE_FILE = "hugegraph.license";
+    public static final String PD_TEMPLATE_FILE = "pd-application.yml.template";
+    public static final String STORE_TEMPLATE_FILE = "store-application.yml.template";
+    public static final String SERVER_TEMPLATE_FILE = "rest-server.properties.template";
+
+    public static final String JAVA_CMD =
+            System.getProperty("java.home")
+            + File.separator
+            + BIN_DIR
+            + File.separator
+            + (SystemUtils.IS_OS_WINDOWS ? "java.exe" : "java");
+
+    public static final String PD_DIST_PATH =
+            System.getProperty(USER_DIR)
+            + File.separator
+            + "hugegraph-pd"
+            + File.separator
+            + DIST_DIR
+            + File.separator;
+
+    public static final String PD_LIB_PATH =
+            getFileInDir(PD_DIST_PATH, PD_PACKAGE_PREFIX)
+            + File.separator
+            + LIB_DIR
+            + File.separator;
+
+    public static final String STORE_DIST_PATH =
+            System.getProperty(USER_DIR)
+            + File.separator
+            + "hugegraph-store"
+            + File.separator
+            + DIST_DIR
+            + File.separator;
+
+    public static final String STORE_LIB_PATH =
+            getFileInDir(STORE_DIST_PATH, STORE_PACKAGE_PREFIX)
+            + File.separator
+            + LIB_DIR
+            + File.separator;
+
+    public static final String SERVER_DIST_PATH =
+            System.getProperty(USER_DIR)
+            + File.separator
+            + "hugegraph-server"
+            + File.separator;
+
+    public static final String SERVER_LIB_PATH =
+            getFileInDir(SERVER_DIST_PATH, SERVER_PACKAGE_PREFIX)
+            + File.separator;
+
+    public static final String CT_DIST_PATH =
+            System.getProperty(USER_DIR)
+            + File.separator
+            + "hugegraph-cluster-test"
+            + File.separator;
+
+    public static final String CT_PACKAGE_PATH =
+            getFileInDir(CT_DIST_PATH, CT_PACKAGE_PREFIX)
+            + File.separator;
+
+    public static final String IT_LOG_PATH =
+            CT_PACKAGE_PATH
+            + LOG
+            + File.separator;
+
+    private ClusterConstant() {
+        throw new IllegalStateException("Utility class");
+    }
+
+    public static String getFileInDir(String path, String fileName) {
+        File dir = new File(path);
+        if (dir.exists() && dir.isDirectory()) {
+            for (File file : dir.listFiles()) {
+                if (file.getName().startsWith(fileName) && !file.getName().endsWith(".gz")) {
+                    return path + file.getName();
+                }
+            }
+        }
+        return "";
+    }
+
+    public static boolean isJava11OrHigher() {
+        String version = System.getProperty("java.version");
+        if (version.startsWith("1.")) {
+            version = version.substring(2, 3);
+        } else {
+            int dot = version.indexOf(".");
+            if (dot != -1) {
+                version = version.substring(0, dot);
+            }
+        }
+        int versionNumber = Integer.parseInt(version);
+        return versionNumber >= 11;
+    }
+}

hugegraph-cluster-test/hg-ct-minicluster/src/main/java/org/apache/hugegraph/ct/base/EnvType.java

@@ -0,0 +1,28 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.hugegraph.ct.base;
+
+public enum EnvType {
+    Simple,
+    MultiNode;
+
+    public static EnvType getSystemEnvType() {
+        String envType = System.getProperty("TestEnv", Simple.name());
+        return EnvType.valueOf(envType);
+    }
+}