HugeGraph Toolchain Local Testing Guide

git clone https://github.com/${GITHUB_USER_NAME}/hugegraph-toolchain.git cd hugegraph-toolchain 

# Set version export COMMIT_ID="master" # Or specific commit hash, e.g. "8b90977"  # Execute installation (script located in /assembly/travis/ directory) hugegraph-client/assembly/travis/install-hugegraph-from-source.sh $COMMIT_ID 

# Hadoop (only required for Loader HDFS tests) hugegraph-loader/assembly/travis/install-hadoop.sh  # MySQL (only required for Loader JDBC tests) hugegraph-loader/assembly/travis/install-mysql.sh $DB_DATABASE $DB_PASS 

curl http://localhost:8080/graphs # Returns {"graphs":["hugegraph"]} indicates success 

docker network create hugegraph-net docker run -itd --name=server -p 8080:8080 --network hugegraph-net hugegraph/hugegraph:latest 

version: '3.8'  services:  hugegraph-server:  image: hugegraph/hugegraph:latest  # Can be replaced with a specific version, or build your own image  container_name: hugegraph-server  ports:  - "8080:8080" # HugeGraph Server HTTP port  environment:  # Configure HugeGraph Server parameters as needed, e.g., backend storage  - HUGEGRAPH_SERVER_OPTIONS="-Dstore.backend=rocksdb"  volumes:  # If you need to persist data or mount configuration files, add volumes here  # - ./hugegraph-data:/opt/hugegraph/data  healthcheck:  test: ["CMD-SHELL", "curl -f http://localhost:8080/graphs || exit 1"]  interval: 10s  timeout: 3s  retries: 5  networks:  - hugegraph-net   # If you need JDBC tests for hugegraph-loader, you can add the following service  # mysql:  # image: mysql:5.7  # container_name: mysql-db  # environment:  # MYSQL_ROOT_PASSWORD: ${DB_PASS:-your_mysql_root_password} # Read from environment variable, or use default  # MYSQL_DATABASE: ${DB_DATABASE:-hugegraph_test_db} # Read from environment variable, or use default  # ports:  # - "3306:3306"  # volumes:  # - ./mysql-data:/var/lib/mysql # Data persistence  # healthcheck:  # test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-p${DB_PASS:-your_mysql_root_password}"]  # interval: 5s  # timeout: 3s  # retries: 5  # networks:  # - hugegraph-net   # If you need Hadoop/HDFS tests for hugegraph-loader, you can add the following services  # namenode:  # image: johannestang/hadoop-namenode:2.0.0-hadoop2.8.5-java8  # container_name: namenode  # ports:  # - "0.0.0.0:9870:9870"  # - "0.0.0.0:8020:8020"  # environment:  # - CLUSTER_NAME=test-cluster  # - HDFS_NAMENODE_USER=root  # - HADOOP_CONF_DIR=/hadoop/etc/hadoop  # volumes:  # - ./config/core-site.xml:/hadoop/etc/hadoop/core-site.xml  # - ./config/hdfs-site.xml:/hadoop/etc/hadoop/hdfs-site.xml  # - namenode_data:/hadoop/dfs/name  # command: bash -c "if [ ! -d /hadoop/dfs/name/current ]; then hdfs namenode -format; fi && /entrypoint.sh"  # healthcheck:  # test: ["CMD", "hdfs", "dfsadmin", "-report"]  # interval: 5s  # timeout: 3s  # retries: 5  # networks:  # - hugegraph-net   # datanode:  # image: johannestang/hadoop-datanode:2.0.0-hadoop2.8.5-java8  # container_name: datanode  # depends_on:  # - namenode  # environment:  # - CLUSTER_NAME=test-cluster  # - HDFS_DATANODE_USER=root  # - HADOOP_CONF_DIR=/hadoop/etc/hadoop  # volumes:  # - ./config/core-site.xml:/hadoop/etc/hadoop/core-site.xml  # - ./config/hdfs-site.xml:/hadoop/etc/hadoop/hdfs-site.xml  # - datanode_data:/hadoop/dfs/data  # healthcheck:  # test: ["CMD", "hdfs", "dfsadmin", "-report"]  # interval: 5s  # timeout: 3s  # retries: 5  # networks:  # - hugegraph-net  networks:  hugegraph-net:  driver: bridge volumes:  namenode_data:  datanode_data: 

<configuration>  <property>  <name>fs.defaultFS</name>  <value>hdfs://namenode:8020</value>  </property> </configuration> 

<configuration>  <property>  <name>dfs.namenode.name.dir</name>  <value>/hadoop/hdfs/name</value>  </property>  <property>  <name>dfs.datanode.data.dir</name>  <value>/hadoop/hdfs/data</value>  </property>  <property>  <name>dfs.permissions.superusergroup</name>  <value>hadoop</value>  </property>  <property>  <name>dfs.support.append</name>  <value>true</value>  </property> </configuration> 

# Start services docker compose up -d  # Check status docker compose ps lsof -i:8080 # Server lsof -i:8020 # Hadoop lsof -i:3306 # MySQL  # Stop services docker compose down 

mvn -e compile -pl hugegraph-client -Dmaven.javadoc.skip=true -ntp 

# 1. Modify authentication mode cp conf/rest-server.properties conf/rest-server.properties.backup sed -i '/^auth.authenticator=/c\auth.authenticator=org.apache.hugegraph.auth.StandardAuthenticator' conf/rest-server.properties grep auth.authenticator conf/rest-server.properties  # 2. Set password # Note: Test code uses "pa" as default password, must match for tests to work bin/stop-hugegraph.sh export PASSWORD="pa" # Set to test default password echo -e "${PASSWORD}" | bin/init-store.sh bin/start-hugegraph.sh 

# Check environment curl http://localhost:8080/graphs # Should return {"graphs":["hugegraph"]} curl -u admin:pa http://localhost:8080/graphs # Authentication test (pa is test default password)  # Run tests cd hugegraph-client mvn test -Dtest=UnitTestSuite -ntp # Unit tests mvn test -Dtest=ApiTestSuite -ntp # API tests (requires Server) mvn test -Dtest=FuncTestSuite -ntp # Functional tests (requires Server) 

mvn install -pl hugegraph-client,hugegraph-loader -am -Dmaven.javadoc.skip=true -DskipTests -ntp 

cd hugegraph-loader mvn test -P unit -ntp # Unit tests mvn test -P file -ntp # File tests (requires Server) mvn test -P hdfs -ntp # HDFS tests (requires Server + Hadoop) mvn test -P jdbc -ntp # JDBC tests (requires Server + MySQL) mvn test -P kafka -ntp # Kafka tests (requires Server) 

mvn install -pl hugegraph-client,hugegraph-loader -am -Dmaven.javadoc.skip=true -DskipTests -ntp cd hugegraph-hubble mvn -e compile -Dmaven.javadoc.skip=true -ntp 

python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate python -m pip install -r hubble-dist/assembly/travis/requirements.txt 

mvn package -Dmaven.test.skip=true # Optional: Start and verify cd apache-hugegraph-hubble-incubating-*/bin ./start-hubble.sh -d && sleep 10 curl http://localhost:8088/api/health ./stop-hubble.sh 

# Unit tests mvn test -P unit-test -pl hugegraph-hubble/hubble-be -ntp  # API tests (requires Server + Hubble running) curl http://localhost:8080/graphs # Check Server curl http://localhost:8088/api/health # Check Hubble cd hugegraph-hubble/hubble-dist ./assembly/travis/run-api-test.sh 

mvn install -pl hugegraph-client,hugegraph-spark-connector -am -Dmaven.javadoc.skip=true -DskipTests -ntp 

cd hugegraph-spark-connector mvn test -ntp # Requires Server running 

mvn install -pl hugegraph-client,hugegraph-tools -am -Dmaven.javadoc.skip=true -DskipTests -ntp 

cd hugegraph-tools mvn test -Dtest=FuncTestSuite -ntp # Requires Server running