Skip to content

Release Voting

Jump to bottom
VGalaxies edited this page Dec 13, 2024 · 12 revisions

0x00. 概要

发送投票邮件时请使用 xxx@apache.org 邮箱发送, 发送前务必在发件箱内设置为纯文本格式, 见官方邮件说明

PS: 发邮件前, 建议 double check 确认 (先发给其他 PMC 检查)

然后有以下注意点:

  1. 所有指向校验和、签名和公钥的链接都必须引用 Apache 主网站, 并检查 KEYS 文件中有你的 GPG 公钥 (与 release 仓库同步)
# 注意是直接修改 release svn 中的 KEYS 文件 (not dev)
svn co https://dist.apache.org/repos/dist/release/incubator/hugegraph/
# 追加 echo 写入个人 PK >> KEYS 中
svn ci --username $ASF_USERNAME --password "$ASF_PASSWORD" -m "Append KEYS for Xxx"
https://downloads.apache.org/incubator/hugegraph/KEYS
  1. 先在 HugeGraph 社区投票, 发送邮件至：dev@hugegraph.apache.org (可选抄送 mentors, 有导师提前参与验证可加速发版进程)
  2. 发送汇总邮件通过后, 再在 Incubator 社区投票, 发送邮件至：general@incubator.apache.org (毕业后则只需在 HugeGraph 社区投票)
  3. 社区投票的邮件正文中的 ${Current Release Manager}, 填写负责本次发布的人员 (e.g: Jack Li )

0x01. HugeGraph 投票阶段

  1. 发起投票邮件到 dev@hugegraph.apache.org。(P)PMC 需要先按照发版文档校验章节确认发版的正确性，然后再进行投票
  2. 经过至少 72 小时并统计到 ≥ 3 个 +1 (P)PMC 票后，才视为正常通过
  3. 72h 后可宣布投票结果，发起投票 [RESULT] 邮件到 dev@hugegraph.apache.org (模板见下)

A. HugeGraph 社区内投票模板 (dev)

下面的模板仅供参考, 请注意使用纯文本模式发送邮件避免乱码: (特别注意修改版本号)

1.5.0 vote 🔗: https://lists.apache.org/thread/jfcr2vlrwn7bzmg32d8ljqpmc6794vj0

可考虑提前 cc 各位 Mentor 的 Mail 📮

邮件标题：
[VOTE] Release Apache HugeGraph (Incubating) 1.x.x

邮件正文：

Hello HugeGraph Community,

This is a call for vote to release Apache HugeGraph (Incubating) version 1.x.x

Release notes:
https://hugegraph.apache.org/docs/changelog/hugegraph-1.x.x-release-notes/

Source and binary files:
https://dist.apache.org/repos/dist/dev/incubator/hugegraph/1.x.x/

Maven artifacts are available in a staging repository:
https://repository.apache.org/content/repositories/orgapachehugegraph-xxxx (server)
https://repository.apache.org/content/repositories/orgapachehugegraph-xxxx (toolchain)
https://repository.apache.org/content/repositories/orgapachehugegraph-xxxx (computer)
https://repository.apache.org/content/repositories/orgapachehugegraph-xxxx (commons)

Git tag & commit hash for the release:
https://github.com/apache/incubator-hugegraph/tree/1.x.x (hashXX)
https://github.com/apache/incubator-hugegraph-toolchain/tree/1.x.x (hashXX)
https://github.com/apache/incubator-hugegraph-computer/tree/1.x.x (hashXX)
https://github.com/apache/incubator-hugegraph-commons/tree/1.x.x (hashXX)

Keys to verify the Release Candidate:
https://downloads.apache.org/incubator/hugegraph/KEYS

The GPG user ID(s): xxxx

The vote will be open for at least 72 hours or until the necessary number of votes are reached.

Please vote accordingly:

  [ ] +1 approve
  [ ] +0 no opinion
  [ ] -1 disapprove with the reason

Checklist for reference:

  [ ] Download links are valid.
  [ ] Checksums and PGP signatures are valid.
  [ ] Source code distributions have correct names matching the current release.
  [ ] LICENSE and NOTICE files are correct for each HugeGraph repo.
  [ ] All files have license headers if necessary.
  [ ] No unlicensed compiled archives bundled in source archive.

More detail checklist  please refer:
https://cwiki.apache.org/confluence/display/INCUBATOR/Incubator+Release+Checklist

Steps to validate the release，Please refer to:
https://hugegraph.apache.org/docs/contribution-guidelines/validate-release/ (EN)
https://hugegraph.apache.org/cn/docs/contribution-guidelines/validate-release/ (CN)


Thanks,
${Current Release Manager}

Note:

  • 这封邮件由本次发版负责人发出, 请先测试发送查看排版是否正常 (务必)
  • 发送邮件后, 请从hugegraph-dev 邮箱里复制邮件链接发到 committer/发版群
  • ASF 推荐发版可使用 apache 邮箱方便身份确认, 请提前在 Gmail 或其他邮箱里配置 apache 邮箱发件设置并测试
  • 参与投票验证的同学, 验证内容 + 回复邮件模板参考此处
  • 对于邮件中的 Git tag & commit hash for the release，tag 最好设置为 1.x.x-rcy，这里的 y 代表第几轮投票，最后在 GitHub Releases 中选取的 tag 即为 1.x.x 无需带上 rc
    • 不用贴 branch 地址, branch 非必须, tag 必须; 记得提前创建好 tag
  • release note 只需保留一个 link 🚧ing 即可

B. 关闭投票邮件

如果投票已达到所需票数(≥3)后，进行结果统计前，需要直接回复投票邮件，说明关闭本次投票会话

Hi,

Thanks, everyone, I will close this vote thread and the results will be tallied.

Best wishes!

${Current Release Manager}

C. 取消投票（可选）

如果反馈了一些严重问题，需要修复后重新发布，则需要先取消投票，发版负责人需要发送取消投票邮件并进行说明:

邮件标题：
[CANCEL][VOTE] Release Apache HugeGraph (Incubating) ${release_version}

邮件正文：
Hello HugeGraph Community,

I'm cancelling this vote [投票链接] because of license issues. I'll fix them and start
the round 2 vote process.
    
The detail of the modifications are as follows:
    
1. Remove the file xxx
2. Removes the files be built from xxx
    
Thanks a lot for all your help.

${Current Release Manager}

D. 宣布投票结果

注：该邮件的 thread 地址可通过访问 hugegraph-dev 邮箱记录页面查到 (加载时间可能会比较长), 然后选择相应邮件点进去后即可生成 thread 链接

邮件标题：
[RESULT][VOTE] Release Apache HugeGraph (Incubating) ${release_version}

邮件正文：
Hello Apache HugeGraph PPMC and Community,

The vote closes now as 72hr have passed. The vote PASSES with

xx (+1 binding) votes from the PPMC (xx, xx, ...)
xx (+1 non-binding) votes from the rest of the developer community (xx, xx)
and no further 0 or -1 votes.

The vote thread: {vote_mail_address}

I will now bring the vote to general@incubator.apache.org to get approval by the IPMC.
If this vote passes also, the release is accepted and will be published.

Thank you for your support.
${Current Release Manager}

Note:

  • PPMC: Podling Project Management Committee (PPMC) , 也就是当前孵化项目的 PMC
  • IPMC: Incubator Project Management Committee (IPMC) 一般是 incubator 社区的 PMC，例如 HugeGraph 的导师都是这个角色

0x02. Incubator 投票阶段

类似的, 如同上面的步骤, 也有几个投票模板, 这里的投票人主要是整个社区的前辈 (包括当前项目的导师)

  1. Incubator 社区投票，发起投票邮件到 general@incubator.apache.org
  2. 等待至少 72h, 且需 IPMC Member ≥ 3 个 +1 投票，才可进入下一阶段
  3. 宣布投票结果，发起投票结果邮件到 general@incubator.apache.org 并抄送邮件至 dev@hugegraph.apache.org

A. Incubator 社区投票模板 (general)

参考示例: (之后可以把上一次的投票链接放此处参考, 记得修改版本号)

1.5.0 vote 🔗: https://lists.apache.org/thread/96f7xptw7q82ykozv95xoc56vfc6z7lc

考虑提前 cc 各位 Mentor 的 Mail 📮 及 (Possibly) Friendly Mail 📮

邮件标题：[VOTE] Release Apache HugeGraph(Incubating) 1.0.0

邮件正文：

Hello Incubator Community,

This is a call for a vote to release Apache HugeGraph(Incubating) version 1.0.0

The Apache HugeGraph community has voted on and approved a proposal to release
Apache HugeGraph(Incubating) version 1.0.0

We now kindly request the Incubator PMC members review and vote on this
incubator release.

HugeGraph community vote thread:
  • [HugeGraph社区投票链接]

Vote result thread:
  • [HugeGraph社区投票结果链接]

The release candidate:
  • https://dist.apache.org/repos/dist/dev/incubator/hugegraph/1.0.0

Git tag for the release:
  • https://github.com/apache/incubator-hugegraph/tree/1.0.0

Release notes:
  • https://hugegraph.apache.org/xxx/release-notes-${release_version}

The artifacts signed with PGP key [参与发版人的KEY], corresponding to [pgp对应的邮箱],
that can be found in public keys file:
  • https://downloads.apache.org/incubator/hugegraph/KEYS

The vote will be open for at least 72 hours or until necessary number of votes are reached.

Please vote accordingly:
  [ ] +1 approve
  [ ] +0 no opinion
  [ ] -1 disapprove with the reason

More detail checklist  please refer:
• https://cwiki.apache.org/confluence/display/INCUBATOR/Incubator+Release+Checklist

Steps to validate the release，Please refer to:
https://hugegraph.apache.org/docs/contribution-guidelines/validate-release/ (EN)
https://hugegraph.apache.org/cn/docs/contribution-guidelines/validate-release/ (CN)


Thanks,
On behalf of Apache HugeGraph(Incubating) community

B. 关闭投票

如果投票已达到所需票数后，进行结果统计前，需要直接回复投票邮件，说明关闭本次投票会话

Hi,

Thanks, everyone, I will close this vote thread and the results will be tallied.

Best wishes!

Apache HugeGraph(Incubating) community

C. 取消投票 (可选)

如果社区导师反馈了一些严重问题，需要修复后重新发布，则需要取消投票，发布负责人需要新起取消投票邮件并进行说明:

邮件标题：
[CANCEL][VOTE] Release Apache HugeGraph (Incubating) ${release_version}

邮件正文：
Hello Incubator Community,

I'm cancelling this vote [投票链接] because of license issues. I'll fix them and start
the round 2 vote process.
    
The detail of the modifications are as follows:
    1. Remove the file xxx
    2. Removes the files be built from xxx
    
Thanks a lot for all your help.

Apache HugeGraph(Incubating) community

D. 宣布投票结果

参考示例, 内容同时抄送至 dev@hugegraph.apache.org, 代表此次发版正式完成

邮件标题：[RESULT][VOTE] Release Apache HugeGraph 1.0.0

邮件正文：
Hi all,

Thanks for reviewing and voting for Apache HugeGraph(Incubating) 1.0.0
release, I am happy to announce the release voting has passed with [投票结果数]
binding votes, no +0 or -1 votes. Binding votes are from IPMC

   - xxx
   - xxx
   - xxx

The voting thread is:
[Incubator社区投票链接]

Many thanks for all our mentors helping us with the release procedure, and
all IPMC helped us to review and vote for Apache HugeGraph(Incubating) release. I will
be working on publishing the artifacts soon.

Thanks
On behalf of Apache HugeGraph(Incubating) community

至此两阶段投票流程才宣告正式完成 ✅, 发版至此已经完成了 95%, 最后的事项见原发版 Wiki 最后章节

0x03. 其他

如若因投票邮件内容有小问题（如链接问题):

  • 如果发现得比较早，可以取消之前的投票，进行再次投票，如果已经进行比较久，可以由版本发布人直接对投票邮件进行回复说明
  • 源码物料不做修改，邮件标题可以添加（Round2）区分，如 [VOTE] Release Apache HugeGraph (Incubating) 1.0.0 (Round2）

Documentation license here.

Clone this wiki locally