复古 护眼 海天 深邃 暗黑 默认

准备工作

1. 检查并更新 NOTICE

检查并更新 NOTICE 文件中的年份。

2. 确认 Release Note

Release Note 需提供中文/英文两种版本,确认中英文描述是否明确,并按以下标签进行分类:

  1. 新功能
  2. API 变更
  3. 功能增强
  4. 漏洞修复

3. 确认 Issue 列表

打开 Github Issues,过滤 Milestone 为 ${RELEASE.VERSION} 且状态为打开的 Issue:

  1. 关闭已完成的 Issue;
  2. 未完成的 Issue 与负责人进行沟通,如果不影响本次发版,修改 Milestone 为下一个版本;
  3. 确认发布版本的 Milestone 下没有打开状态的 Issue。

4. 确认 Pull Request 列表

打开 Github Pull requests,过滤 Milestone 为 ${RELEASE.VERSION} 且状态为打开的 Pull Request:

  1. 对打开的 Pull Request 进行 Review 并且 Merge;
  2. 无法 Merge 且不影响本次发版的 Pull Request,修改 Milestone 为下一个版本;
  3. 确认发布版本的 Milestone 下没有打开状态的 Pull Request。

5. 发送讨论邮件

  1. 发送邮件至 dev@shardingsphere.apache.org,在邮件正文中链接 GitHub Discussion;
  2. 关注邮件列表,确认社区开发者对 Release Note 没有任何疑问。

6. 关闭 Milestone

打开 Github Milestone

  1. 确认 ${RELEASE.VERSION} 的 Milestone 完成状态为 100%;
  2. 点击 Close 关闭 Milestone。

GPG 设置

1. 安装 GPG

GnuPG 官网下载安装包。 GnuPG 的 1.x 版本和 2.x 版本的命令有细微差别,下列说明以 GnuPG-2.1.23 版本为例。

安装完成后,执行以下命令查看版本号。

gpg --version

2. 创建 key

安装完成后,执行以下命令创建 key。

GnuPG-2.x 可使用:

gpg --full-gen-key

GnuPG-1.x 可使用:

gpg --gen-key

根据提示完成 key:

注意:请使用个人 Apache 邮箱生成 GPG 的 Key。

gpg (GnuPG) 2.0.12; Copyright (C) 2009 Free Software Foundation, Inc.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Please select what kind of key you want:
  (1) RSA and RSA (default)
  (2) DSA and Elgamal
  (3) DSA (sign only)
  (4) RSA (sign only)
Your selection? 1
RSA keys may be between 1024 and 4096 bits long.
What keysize do you want? (2048) 4096
Requested keysize is 4096 bits
Please specify how long the key should be valid.
        0 = key does not expire
     <n>  = key expires in n days
     <n>w = key expires in n weeks
     <n>m = key expires in n months
     <n>y = key expires in n years
Key is valid for? (0)
Key does not expire at all
Is this correct? (y/N) y

GnuPG needs to construct a user ID to identify your key.

Real name: ${输入用户名}
Email address: ${输入邮件地址}
Comment: ${输入注释}
You selected this USER-ID:
   "${输入的用户名} (${输入的注释}) <${输入的邮件地址}>"

Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit? O
You need a Passphrase to protect your secret key. # 输入密码

3. 查看生成的 key

gpg --list-keys

执行结果:

pub   4096R/700E6065 2019-03-20
uid                  ${用户名} (${注释}) <{邮件地址}>
sub   4096R/0B7EF5B2 2019-03-20

其中 700E6065 为公钥 ID。

或者使用 gpg --list-sigs 查看。

4. 导出 v1 版本密钥

gpg --export >~/.gnupg/pubring.gpg
gpg --export-secret-keys >~/.gnupg/secring.gpg

5. 将公钥同步到服务器

命令如下:

gpg --keyserver hkp://keyserver.ubuntu.com --send-key 700E6065

keyserver.ubuntu.com 为随意挑选的公钥服务器,每个服务器之间是自动同步的,选任意一个即可。

准备发布分支

1. 创建发布分支

假设从 Github 下载的 ShardingSphere on Cloud 源代码在 ~/shardingsphere-on-cloud/ 目录;假设即将发布的版本为 ${RELEASE.VERSION}。 创建 ${RELEASE.VERSION}-release 分支,接下来的操作都在该分支进行。

## ${name} 为源码所在分支,如:master,dev-4.x
git clone --branch ${name} https://github.com/apache/shardingsphere-on-cloud.git ~/shardingsphere-on-cloud
cd ~/shardingsphere-on-cloud/
git pull
git checkout -b ${RELEASE.VERSION}-release
git push origin ${RELEASE.VERSION}-release

2. 更新 charts 版本及 release notes

在发布分支上更新文件中的版本,包括:Chart.yamlvalues.yaml、文档。示例:

~/shardingsphere-on-cloud/charts/apache-shardingsphere-operator-charts/Chart.yaml
~/shardingsphere-on-cloud/charts/apache-shardingsphere-proxy-charts/Chart.yaml

version 修改为 ${RELEASE.VERSION}appVersion 修改为对应的应用版本,并提交 PR 到发布分支。

更新 RELEASE-NOTES.md

3. 创建发布 tag

在发布分支上创建发布 tag,并推送到远程仓库。

git tag ${RELEASE.VERSION}
git push origin ${RELEASE.VERSION}

4. 打包 charts

打包 charts 之前需要通过 helm dependency build 命令下载依赖的包,然后再对 charts 进行打包,具体操作步骤如下:

cd ~/shardingsphere-on-cloud/charts/apache-shardingsphere-operator-charts
helm dependency build

cd ~/shardingsphere-on-cloud/charts/apache-shardingsphere-proxy-charts/charts/governance
helm dependency build

cd ~/shardingsphere-on-cloud/charts/apache-shardingsphere-proxy-charts
helm dependency build

cd ~/shardingsphere-on-cloud/charts
helm package --sign --key '${GPG 用户名}' --keyring ~/.gnupg/secring.gpg apache-shardingsphere-operator-charts
helm package --sign --key '${GPG 用户名}' --keyring ~/.gnupg/secring.gpg apache-shardingsphere-proxy-charts

5. GitHub 版本预发布

GitHub Releases 页面创建新版本。

编辑版本号及版本说明,选择 Set as a pre-release,并点击 Publish release

6. 上传 charts

上传前面生成的 tgz 文件至 GitHub release 的 Assets 下。

检查发布结果

1. 检查 gpg 签名

首先导入发布人公钥。从 svn 仓库导入 KEYS 到本地环境。(发布版本的人不需要再导入,帮助做验证的人需要导入,用户名填发版人的即可)

curl https://dist.apache.org/repos/dist/dev/shardingsphere/KEYS >> KEYS
gpg --import KEYS
gpg --edit-key "${发布人的 gpg 用户名}"
  > trust

Please decide how far you trust this user to correctly verify other users' keys
(by looking at passports, checking fingerprints from different sources, etc.)

  1 = I don't know or won't say
  2 = I do NOT trust
  3 = I trust marginally
  4 = I trust fully
  5 = I trust ultimately
  m = back to the main menu

Your decision? 5

  > save

下载所有 prov 文件和 tgz 文件,然后进行 gpg 签名检查。

Bash 可以使用以下命令检查签名:

for each in $(ls *.tgz); do helm verify $each; done

或逐个文件检查:

helm verify apache-shardingsphere-operator-${RELEASE.VERSION}.tgz
helm verify apache-shardingsphere-operator-cluster-${RELEASE.VERSION}.tgz
helm verify apache-shardingsphere-proxy-${RELEASE.VERSION}.tgz

2. 检查发布文件内容

解压缩

  • apache-shardingsphere-operator-charts-${RELEASE.VERSION}.tgz
  • apache-shardingsphere-proxy-charts-${RELEASE.VERSION}.tgz

进行如下检查:

  • 存在 LICENSENOTICE 文件;
  • NOTICE 文件中的年份正确;
  • 所有文本文件开头都有 ASF 许可证,以下文件除外:
    • 所有 Chart.yaml
    • 所有 Chart.lock
  • 检查第三方依赖许可证:
    • 第三方依赖的许可证兼容;
    • 所有第三方依赖的许可证都在 LICENSE 文件中声明;
    • 依赖许可证的完整版全部在 license 目录;
    • 如果依赖的是 Apache 许可证并且存在 NOTICE 文件,那么这些 NOTICE 文件也需要加入到版本的 NOTICE 文件中。

发起投票

投票阶段

  1. ShardingSphere 社区投票,发起投票邮件到 dev@shardingsphere.apache.org。PMC 需要先按照文档检查版本的正确性,然后再进行投票。 经过至少 72 小时 并统计到 3 个 +1 PMC member 票后,即可进入下一阶段的投票。

  2. 宣布投票结果,发起投票结果邮件到 dev@shardingsphere.apache.org

投票模板

  1. ShardingSphere 社区投票模板

标题:

[VOTE] Release Apache ShardingSphere on Cloud ${RELEASE.VERSION}

正文:

Hello ShardingSphere Community,

This is a call for vote to release Apache ShardingSphere on Cloud version ${RELEASE.VERSION}

Release notes:
https://github.com/apache/shardingsphere-on-cloud/blob/${RELEASE.VERSION}-release/RELEASE-NOTES.md

The release candidates:
https://github.com/apache/shardingsphere-on-cloud/releases/tag/${RELEASE.VERSION}

Git tag for the release:
https://github.com/apache/shardingsphere-on-cloud/tree/${RELEASE.VERSION}/

Release Commit ID:
https://github.com/apache/shardingsphere-on-cloud/commit/xxxxxxxxxxxxxxxxxxxxxxx

Keys to verify the Release Candidate:
https://dist.apache.org/repos/dist/dev/shardingsphere/KEYS

Look at here for how to verify this release candidate:
https://shardingsphere.apache.org/community/en/involved/release/shardingsphere-on-cloud/

GPG user ID:
${YOUR.GPG.USER.ID}

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

PMC vote is "+1 binding", all others is "+1 non-binding".

Checklist for reference:

[ ] Checksums and PGP signatures are valid.

[ ] LICENSE and NOTICE files are correct for each ShardingSphere on Cloud repo.

[ ] All files have license headers if necessary.
  1. 宣布投票结果模板:

标题:

[RESULT][VOTE] Release Apache ShardingSphere on Cloud ${RELEASE.VERSION}

正文:

We’ve received 3 "+1 binding" votes and one "+1 non-binding" vote:

+1 binding, xxx
+1 binding, xxx
+1 binding, xxx

+1 non-binding, xxx

Thank you everyone for taking the time to review the release and help us.
I will process to publish the release and send ANNOUNCE.

完成发布

1. 合并 release 分支到 main,合并完成后删除 release 分支

提交 PR 到 GitHub,将分支 ${RELEASE.VERSION}-release 合并到 main

2. 生成并替换 index.yaml

  1. 生成 index.yaml
cd ~/shardingsphere-on-cloud/charts
mkdir release
mv *.tgz release
git checkout gh-pages
cd release
mv ~/shardingsphere-on-cloud/index.yaml .
helm repo index --url https://github.com/apache/shardingsphere-on-cloud/releases/download/${RELEASE.VERSION} . --merge index.yaml

检查 index.yaml 新生成的 url 是否可用。

  1. 替换原有的 index.yaml
cp index.yaml ~/shardingsphere-on-cloud/index.yaml

提交 PR 到 GitHub 并合并到 gh-pages 分支。

3. 检查仓库制品

更新仓库并查询:

helm repo remove apache
helm repo add apache  https://apache.github.io/shardingsphere-on-cloud
helm search repo apache

helm repo addhelm search repo -l 会根据 index.yaml 中的校验值进行校验。

如果查询到以下两个制品并且版本号正确,即为发布成功:

NAME                                              	CHART VERSION	           APP VERSION	DESCRIPTION
apache/apache-shardingsphere-operator-charts     	${RELEASE.VERSION}       	xxx     	A Helm chart for ShardingSphere-Operator
apache/apache-shardingsphere-proxy-charts        	${RELEASE.VERSION}        	xxx         A Helm chart for ShardingSphere-Proxy-Cluster

4. GitHub 版本发布

GitHub Releases 页面编辑最新版本, 选择 Set as the latest release,并点击 Update release

5. 邮件通知版本发布完成

使用纯文本模式发送邮件到 dev@shardingsphere.apache.organnounce@apache.org 通知完成版本发布。

通知邮件模板:

标题:

[ANNOUNCE] Apache ShardingSphere on Cloud ${RELEASE.VERSION} available

正文:

Hi all,

Apache ShardingSphere Team is glad to announce the new release of Apache ShardingSphere on Cloud ${RELEASE.VERSION}.

The shardingsphere-on-cloud project, including ShardingSphere Operator, Helm Charts, and other cloud solutions, aims at enhancing the deployment and management capabilities of Apache ShardingSphere Proxy on the cloud.
ShardingSphere Operator is a Kubernetes software extension written with the Operator extension pattern of Kubernetes. ShardingSphere Operator can be used to quickly deploy an Apache ShardingSphere Proxy cluster in the Kubernetes environment and manage the entire cluster life cycle.

Download Links: https://github.com/apache/shardingsphere-on-cloud/releases/tag/${RELEASE.VERSION}

Release Notes: https://github.com/apache/shardingsphere-on-cloud/blob/master/RELEASE-NOTES.md

Website: https://shardingsphere.apache.org/

ShardingSphere on Cloud Resources:
- Issue: https://github.com/apache/shardingsphere-on-cloud/issues/
- Mailing list: dev@shardingsphere.apache.org
- Documents: https://shardingsphere.apache.org/oncloud/current/en/overview/



- Apache ShardingSphere Team