1git clone https://github.com/<your-name>/hugegraph.git
2cd hugegraph
3git remote add upstream https://github.com/apache/hugegraph.git
4git fetch upstream master

1git switch master
2git merge --ff-only upstream/master
3git switch -c fix/<short-description>

1hugegraph-server/hugegraph-core/src/main/java/org/apache/hugegraph/

1# Core 测试，使用内存后端
2mvn test -pl hugegraph-server/hugegraph-test -am -P core-test,memory
3
4# API 测试，使用 RocksDB 后端
5mvn test -pl hugegraph-server/hugegraph-test -am -P api-test,rocksdb
6
7# 格式化并检查编译
8mvn editorconfig:format
9mvn clean compile -Dmaven.javadoc.skip=true

1git add <changed-files>
2git commit -m "fix(core): handle empty vertex query"
3git push -u origin fix/<short-description>

1git fetch upstream master
2git rebase upstream/master
3git push --force-with-lease

1bash dist/validate-release.sh --svn-path 1.8.0/RC1 \
2  --staging-repository https://repository.apache.org/content/repositories/<staging-id>/ 1.8.0 imbajin
3# 原有本地包位置参数接口保留：
4bash dist/validate-release.sh 1.8.0 imbajin /path/to/rc 17

 1# 1. 安装svn
 2# ubuntu/debian
 3sudo apt install subversion -y
 4# MacOS
 5brew install subversion
 6# 验证安装是否成功, 执行以下命令:
 7svn --version
 8
 9# 2. 安装gpg
10# ubuntu/debian
11sudo apt-get install gnupg -y
12# MacOS
13brew install gnupg
14# 验证安装是否成功, 执行以下命令:
15gpg --version
16
17# 3. 安装wget
18# ubuntu/debian
19sudo apt-get install wget -y
20# MacOS
21brew install wget
22
23# 4. 下载 hugegraph-svn 目录 (版本号注意填写此次验证版本)
24svn co https://dist.apache.org/repos/dist/dev/hugegraph/1.x.x/
25# (注) 如果出现 svn 下载某个文件速度很慢的情况, 可以考虑 wget 单个文件下载, 如下 (或考虑使用 VPN / 代理)
26wget https://dist.apache.org/repos/dist/dev/hugegraph/1.x.x/apache-hugegraph-toolchain-1.x.x.tar.gz

1执行命令:
2for i in *.tar.gz; do echo $i; shasum -a 512 --check  $i.sha512; done

 1# 1. 下载项目可信赖公钥到本地 (首次需要) & 导入
 2curl  https://downloads.apache.org/hugegraph/KEYS > KEYS
 3gpg --import KEYS
 4
 5# 导入后可以看到如下输出, 这代表导入了 x 个用户公钥
 6gpg: /home/ubuntu/.gnupg/trustdb.gpg: trustdb created
 7gpg: key BA7E78F8A81A885E: public key "imbajin (apache mail) <jin@apache.org>" imported
 8gpg: key 818108E7924549CC: public key "vaughn <vaughn@apache.org>" imported
 9gpg: key 28DCAED849C4180E: public key "coderzc (CODE SIGNING KEY) <zhaocong@apache.org>" imported
10....
11gpg: Total number processed: x
12gpg:               imported: x
13
14# 2. 将完整主密钥指纹与发版投票邮件中的签名者指纹对照
15release_signer_fingerprint='<signer-full-fingerprint>'
16gpg --fingerprint -- "$release_signer_fingerprint"
17
18# 3. 在子 shell 中验证，失败时停止检查但不退出交互终端
19(
20  for archive in *.tar.gz; do
21    gpg --status-fd 1 --verify -- "$archive.asc" "$archive" > "$archive.status" || {
22      status=$?
23      printf 'Signature verification failed: %s\n' "$archive" >&2
24      cat "$archive.status"
25      exit "$status"
26    }
27    cat "$archive.status"
28    if grep -Eq '^\[GNUPG:\] (REVKEYSIG|EXPKEYSIG|EXPSIG)( |$)' "$archive.status"; then
29      printf 'Expired or revoked signature: %s\n' "$archive" >&2
30      exit 1
31    fi
32    grep -q '^\[GNUPG:\] VALIDSIG ' "$archive.status" || {
33      printf 'Missing valid signature: %s\n' "$archive" >&2
34      exit 1
35    }
36  done
37)

1# 请优先使用/切换到 `java 17` 版本进行后序的编译和运行操作 (注:`Computer` 仅支持 `java >= 11`)
2# java --version
3
4# 尝试在 Unix 环境下编译测试是否正常
5mvn -s /path/to/staging-settings.xml -Dmaven.repo.local=/path/to/fresh-m2 \
6  clean install -Papache-release -DskipTests -Dgpg.skip=true

 1# hugegraph-server
 2bin/start-hugegraph.sh
 3
 4# hugegraph-loader
 5bin/hugegraph-loader.sh -g hugegraph -f example/file/struct.json -s example/file/schema.groovy
 6
 7# hugegraph-hubble
 8bin/start-hubble.sh
 9
10更多参考官网: https://hugegraph.apache.org/cn/docs/quickstart

1[] +1 approve
2
3[] +0 no opinion
4
5[] -1 disapprove with the reason

 1+1 (non-binding)
 2I checked:
 31. Download link/tag in mail are valid
 42. Checksum and GPG signatures are OK
 53. LICENSE & NOTICE exist
 64. Build successfully on XX OS version XXX
 75. No unexpected binary files
 86. Date is right in the NOTICE file
 97. Compile from source is fine under JavaX
108. No empty file & directory found
119. Test running xxx service OK
1210. ....

 1+1 (binding)
 2I checked:
 31. Download link/tag in mail are valid
 42. Checksum and GPG signatures are OK
 53. LICENSE & NOTICE exist
 64. Build successfully on XX OS Version XX
 75. No unexpected binary files
 86. Date is right in the NOTICE file
 97. Compile from source is fine under JavaXX
108. No empty file & directory found
119. Test running XXX service OK
1210. ....

1git clone https://github.com/apache/hugegraph.git

1cp -r hugegraph-server/hugegraph-dist/src/assembly/static/scripts \
2      hugegraph-server/hugegraph-dist/src/assembly/static/conf \
3      path-to-your-directory

1backend=rocksdb
2serializer=binary
3rocksdb.data_path=.
4rocksdb.wal_path=.

 12023-06-05 00:43:37 [main] [INFO] o.a.h.u.ConfigUtil - Scanning option 'graphs' directory './conf/graphs'
 22023-06-05 00:43:37 [main] [INFO] o.a.h.c.InitStore - Init graph with config file: ./conf/graphs/hugegraph.properties
 3......
 42023-06-05 00:43:39 [main] [INFO] o.a.h.b.s.r.RocksDBStore - Write down the backend version: 1.11
 52023-06-05 00:43:39 [main] [INFO] o.a.h.StandardHugeGraph - Graph 'hugegraph' has been initialized
 62023-06-05 00:43:39 [main] [INFO] o.a.h.StandardHugeGraph - Close graph standardhugegraph[hugegraph]
 72023-06-05 00:43:39 [db-open-1] [INFO] o.a.h.b.s.r.RocksDBStore - Opening RocksDB with data path: ./m
 82023-06-05 00:43:39 [db-open-1] [INFO] o.a.h.b.s.r.RocksDBStore - Opening RocksDB with data path: ./s
 92023-06-05 00:43:39 [db-open-1] [INFO] o.a.h.b.s.r.RocksDBStore - Opening RocksDB with data path: ./g
102023-06-05 00:43:39 [main] [INFO] o.a.h.HugeFactory - HugeFactory shutdown
112023-06-05 00:43:39 [hugegraph-shutdown] [INFO] o.a.h.HugeFactory - HugeGraph is shutting down

1......
22023-06-05 00:51:56 [gremlin-server-boss-1] [INFO] o.a.t.g.s.GremlinServer - Gremlin Server configured with worker thread pool of 1, gremlin pool of 8 and boss thread pool of 1.
32023-06-05 00:51:56 [gremlin-server-boss-1] [INFO] o.a.t.g.s.GremlinServer - Channel started at port 8182.

1public String list(@Context GraphManager manager,
2                   @PathParam("graph") String graph, @QueryParam("label") String label,
3                   @QueryParam("properties") String properties, ......) {
4    // ignore log
5    Map<String, Object> props = parseProperties(properties);

1curl "http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/graph/vertices" | gunzip

 1To: private@hugegraph.apache.org
 2Subject: [DISCUSS] XXX as a HugeGraph Committer Candidate
 3
 4Hi all:
 5
 6I am pleased to nominate xxx for the role of HugeGraph Committer based on his/her contributions over the past few months.
 7
 8[ Candidate's Contribution Summary ]
 9
10Here are the relevant PRs (issues) he/she has participated in:
11
12**Core Features:**
13- Feature 1: [ Reference Links ]
14- ...
15
16**Fix/Chore/Release:**
17
18**Doc:**
19
20[ Candidate's Current Notable Contributions ]
21
22His/Her contributions bring the following benefits to the community, helping us in the following ways:
23
24[ Candidate's Contributions and Benefits to the Community ]
25
26In view of the above contributions, I elect xxx as Committer of the HugeGraph project.
27
28[ Reference Links ]
291. PR1
302. PR2
313. ...
32
33Welcome everyone to share opinions~
34
35Thanks!

 1To: private@hugegraph.apache.org
 2Subject: [VOTE] xxx as a HugeGraph Committer
 3
 4Hi all:
 5
 6Through the discussion of last week:
 7[ Discussion Mailing List Link ]
 8
 9We have discussed and listed what xxx participated in the HugeGraph community.
10I believe making him/her a Committer will enhance the work for HugeGraph. 
11
12So, I am happy to call VOTE to accept xxx as a HugeGraph Committer.
13 
14Voting will continue for at least 72 hours or until the required number of votes is reached.
15 
16Please vote accordingly:
17[ ] +1 approve
18[ ] +0 no opinion
19[ ] -1 disapprove with the reason  
20
21Thanks!

 1To: private@hugegraph.apache.org
 2Subject: [RESULTS][VOTE] xxx as a HugeGraph Committer
 3
 4Hi all: The vote for "xxx" as a HugeGraph Committer has PASSED and closed now.
 5
 6The result is as follows: X PMC +1 Votes: 
 7- A (PMC ID)
 8- B
 9- C...
10
11Vote thread:
12put vote thread link here
13 
14Then I'm going to invite xxx to join us soon. Thanks for everyone's support!

 1To: [ Candidate's Email ]
 2Cc: private@hugegraph.apache.org
 3Subject: Invitation to become HugeGraph committer: xxx
 4
 5Hello xxx,
 6
 7The HugeGraph Project Management Committee (PMC)
 8hereby offers you committer privileges to the project.
 9These privileges are offered on the understanding that you'll use them
10reasonably and with common sense. We like to work on trust
11rather than unnecessary constraints.
12
13Being a committer enables you to more easily make
14changes without needing to go through the patch
15submission process.
16
17Being a committer does not require you to
18participate any more than you already do. It does
19tend to make one even more committed.  You will
20probably find that you spend more time here.
21
22Of course, you can decline and instead remain as a
23contributor, participating as you do now.
24
25A. This personal invitation is a chance for you to
26accept or decline in private.  Either way, please
27let us know in reply to the private@hugegraph.apache.org
28address only.
29
30B. If you accept, the next step is to register an iCLA:
31    1. Details of the iCLA and the forms are found
32    through this link: https://www.apache.org/licenses/#clas
33
34    2. Instructions for its completion and return to
35    the Secretary of the ASF are found at
36    https://www.apache.org/licenses/#submitting
37
38    3. When you transmit the completed iCLA, request
39    to notify the Apache HugeGraph project and choose a
40    unique Apache ID. Look to see if your preferred
41    ID is already taken at
42    https://people.apache.org/committer-index.html
43    This will allow the Secretary to notify the PMC
44    when your iCLA has been recorded.
45
46When recording of your iCLA is noted, you will
47receive a follow-up message with the next steps for
48establishing you as a committer.
49
50With the expectation of your acceptance, welcome!
51
52The Apache HugeGraph PMC

 1To: [ Sender's Email ]
 2Cc: private@hugegraph.apache.org
 3Subject: Re: Invitation to become HugeGraph committer: xxx
 4
 5Hello Apache HugeGraph PMC,
 6
 7I accept the invitation.
 8
 9Thanks to the Apache HugeGraph Community for recognizing my work, I
10will continue to actively participate in the work of the Apache
11HugeGraph.
12
13Next, I will follow the instructions to complete the next steps:
14Signing and submitting iCLA and registering Apache ID.
15
16xxx

 1To: secretary@apache.org
 2Subject: ICLA Information
 3
 4Hello everyone:
 5
 6I have accepted the Apache HugeGraph PMC invitation to
 7become a HugeGraph committer, the attachment is my ICLA information.
 8
 9(Optional) My GitHub account is https://github.com/xxx. Thanks!
10
11xxx

1Dear xxx,
2
3This message acknowledges receipt of your ICLA, which has been filed in the Apache Software Foundation records.
4
5Your account (with id xxx) has been requested for you and you should receive email with next steps
6within the next few days (this process can take up to a week).
7
8Please refer to https://www.apache.org/foundation/how-it-works.html#developers
9for more information about roles at Apache.

 1To: dev@hugegraph.apache.org
 2Subject: [ANNOUNCE] New Committer: xxx
 3
 4Hi everyone, The PMC for Apache HugeGraph has invited xxx to
 5become a Committer and we are pleased to announce that he/she has accepted.
 6
 7xxx is being active in the HugeGraph community & dedicated to ... modules, 
 8and we are glad to see his/her more interactions with the community in the future.
 9
10(Optional) His/Her GitHub account is https://github.com/xxx
11
12Welcome xxx, and please enjoy your community journey~ 
13
14Thanks! 
15
16The Apache HugeGraph PMC