You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@doris.apache.org by mo...@apache.org on 2020/10/28 15:23:17 UTC
[incubator-doris] branch master updated: [Doc] Modify release
manual (#4741)
This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-doris.git
The following commit(s) were added to refs/heads/master by this push:
new d0e8420 [Doc] Modify release manual (#4741)
d0e8420 is described below
commit d0e8420d3975d3e85fbfb179096fc69f8b7176a4
Author: EmmyMiao87 <52...@qq.com>
AuthorDate: Wed Oct 28 23:22:58 2020 +0800
[Doc] Modify release manual (#4741)
Add more details
---
docs/en/community/release-process.md | 137 +++++++++++++++++++------------
docs/en/downloads/downloads.md | 1 +
docs/zh-CN/community/release-process.md | 141 ++++++++++++++++++++------------
docs/zh-CN/downloads/downloads.md | 1 +
4 files changed, 177 insertions(+), 103 deletions(-)
diff --git a/docs/en/community/release-process.md b/docs/en/community/release-process.md
index 6b0996c..420b49f 100644
--- a/docs/en/community/release-process.md
+++ b/docs/en/community/release-process.md
@@ -36,16 +36,21 @@ The general process of publication is as follows:
2. cutting a release branch
3. clean up issues
4. merging necessary patch to release branch
-3. Running the voting process for a release
+3. Verify branch
+ 1. QA stability test
+ 2. Verify the correctness of the compiled image
+ 3. Prepare Release Nodes
+4. Running the voting process for a release
1. singing a tag and upload it to [Apache dev svn repo](https://dist.apache.org/repos/dist/dev/incubator/doris)
2. calling votes from [Doris community](dev@doris.apache.org)
3. send result email to [Doris community](dev@doris.apache.org)
4. calling votes from [Incubator community](general@incubator.apache.org)
5. send result email to general@incubator.apache.org
-4. Finalizing and posting a release
+5. Finalizing and posting a release
1. Upload the signature package to [Apache release repo](https://dist.apache.org/repos/dist/release/incubator/doris) and generate relevant links
- 2. Prepare release note and send Announce mail to general@incubator.apache.org
- 3. Publish download links on Doris website and GitHub
+ 2. Publish download links on Doris website and GitHub
+ 3. Send Announce mail to general@incubator.apache.org
+
## prepare setup
@@ -168,9 +173,13 @@ Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit? o
Real name needs to be consistent with the ID shown in ID. apache. org.
Email address is apache's mailbox.
+Enter passphrase, you need to enter it twice. The passphrase must more than 8 characters.
+
+**The passphrase here must be remembered, it will be used when signing later**
+
##### View and Output
-The first line shows the name of the public key file (pubring.gpg), the second line shows the public key characteristics (4096 bits, Hash string and generation time), the third line shows the "user ID", and the fourth line shows the private key characteristics.
+The first line displays the public key file name (pubring.gpg), the second line displays the characteristics of the public key (4096 bits, Hash string and the generation time), the third line displays "User ID", comments, email, and the fourth line displays Private key characteristics.
```
$ gpg --list-keys
@@ -189,6 +198,7 @@ gpg --armor --output public-key.txt --export [UserID]
```
$ gpg --armor --output public-key.txt --export xxx-yyy
+文件‘public-key.txt’已存在。 是否覆盖？(y/N)y
$ cat public-key.txt
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG V2.0.22 (GNU /Linux)
@@ -282,6 +292,30 @@ Go through all the issues belonging to this version, close those that have been
During the release waiting process, there may be more important patch merging. If someone in the community says that there is an important bug to merge, then release manager needs to evaluate and merge the important patches into the release branch.
+## Verify branch
+
+### QA stability test
+
+Give the prepared branch to QA students for stability testing. If there is a problem that needs to be fixed during the testing process, if there is a problem that needs to be fixed during the testing process, after the problem is fixed, the PR that fixes the problem needs to be merged into the branch of the release version.
+
+After the entire branch is stable, the release can be prepared.
+
+### Verify the correctness of the compiled image
+
+1. Download the compiled image
+
+ ```
+ docker pull apachedoris/doris-dev:build-env-1.2
+ ```
+
+2. Use official documents to compile the new branch, see [Docker Development Mirror Compilation](http://doris.apache.org/master/zh-CN/installing/compilation.html)
+
+ After entering the mirror, the compilation may take about 3~4 hours, please be patient.
+
+ If the compilation fails due to the lack of some third-party libraries, the compilation image needs to be updated.
+
+3. Rebuild the image
+
## Running the voting process for a release
### dozen Tags
@@ -348,7 +382,7 @@ svn add 0.9.0-rc1
svn commit -m "Release Apache Doris (incubating) 0.9.0 rc1"
```
-### Send community voting emails
+### Send e-mail to community dev@doris.apache.org about voting
[VOTE] Release Apache Doris 0.9.0-incubating-rc01
@@ -561,14 +595,57 @@ Copy the source package, signature file and hash file from the corresponding RC
KEYS files also need to be copied if they are first released. Then add to SVN release.
```
-
+After the add is successful, you can see the file you posted on the following URL
https://dist.apache.org/repos/dist/release/incubator/doris/0.9.0-incubating/
-Eventually you can see it on apache's website:
+After waiting for a while, you can see on the official apache website:
http://www.apache.org/dist/incubator/doris/0.9.0-incubating/
```
+### Publish links on Doris website and GitHub
+
+#### Create Download Links
+
+Download link:
+http://www.apache.org/dyn/closer.cgi?filename=incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz&action=download
+
+wget --trust-server-names "https://www.apache.org/dyn/mirrors/mirrors.cgi?action=download&filename=incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz"
+
+Original location:
+https://www.apache.org/dist/incubator/doris/0.9.0-incubating/
+
+http://www.apache.org/dyn/closer.cgi/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz
+
+Source package:
+http://www.apache.org/dyn/closer.cgi/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz
+
+ASC:
+http://archive.apache.org/dist/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz.asc
+
+sha512:
+http://archive.apache.org/dist/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz.sha512
+
+KEYS:
+http://archive.apache.org /dist /incubator /doris /KEYS
+
+refer to: <http://www.apache.org/dev/release-download-pages#closer>
+
+#### Prepare release note
+
+The following two areas need to be modified:
+
+1. Github's release page
+
+```
+https://github.com/apache/incubator-doris/releases/tag/0.9.0-rc01
+```
+
+2. Doris Official Website Download Page
+
+```
+http://doris.apache.org /downloads.html
+```
### Send Announce e-mail to general@incubator.apache.org
@@ -595,7 +672,7 @@ We are pleased to announce the release of Apache Doris 0.9.0-incubating.
Apache Doris (incubating) is an MPP-based interactive SQL data warehousing for reporting and analysis.
The release is available at:
-http://doris.apache.org/downloads.html
+http://doris.apache.org/master/en/downloads/downloads.html
Thanks to everyone who has contributed to this release, and the release note can be found here:
https://github.com/apache/incubator-doris/releases
@@ -628,46 +705,4 @@ visit: https://incubator.apache.org/projects/doris.html
```
-### Publish links on Doris website and GitHub
-
-#### Create Download Links
-
-Download link:
-http://www.apache.org/dyn/closer.cgi?filename=incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz&action=download
-
-wget --trust-server-names "https://www.apache.org/dyn/mirrors/mirrors.cgi?action=download&filename=incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz"
-
-Original location:
-https://www.apache.org/dist/incubator/doris/0.9.0-incubating/
-
-http://www.apache.org/dyn/closer.cgi/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz
-
-Source package:
-http://www.apache.org/dyn/closer.cgi/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz
-
-ASC:
-http://archive.apache.org/dist/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz.asc
-
-sha512:
-http://archive.apache.org/dist/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz.sha512
-
-KEYS:
-http://archive.apache.org /dist /incubator /doris /KEYS
-
-refer to: <http://www.apache.org/dev/release-download-pages#closer>
-
-#### Prepare release note
-
-The following two areas need to be modified:
-
-1. Github's release page
-
-```
-https://github.com/apache/incubator-doris/releases/tag/0.9.0-rc01
-```
-
-2. Doris Official Website Download Page
-```
-http://doris.apache.org /downloads.html
-```
diff --git a/docs/en/downloads/downloads.md b/docs/en/downloads/downloads.md
index 92ff79e..20b1005 100644
--- a/docs/en/downloads/downloads.md
+++ b/docs/en/downloads/downloads.md
@@ -30,6 +30,7 @@ You can download source code from following links, then compile and install Dori
| Version | Release Date | Download Source from Mirror |
|---|---|---|
+| 0.13.0 | 2020-10-24 | [Source](https://www.apache.org/dyn/closer.cgi?path=/incubator/doris/0.13.0-incubating/apache-doris-0.13.0-incubating-src.tar.gz) ([Signature]3https://www.apache.org/dist/incubator/doris/0.13.0-incubating/apache-doris-0.13.0-incubating-src.tar.gz.asc) [SHA512](https://www.apache.org/dist/incubator/doris/0.13.0-incubating/apache-doris-0.13.0-incubating-src.tar.gz.sha512))|
| 0.12.0 | 2020-04-24 | [Source](https://www.apache.org/dyn/closer.cgi?path=/incubator/doris/0.12.0-incubating/apache-doris-0.12.0-incubating-src.tar.gz) ([Signature](https://www.apache.org/dist/incubator/doris/0.12.0-incubating/apache-doris-0.12.0-incubating-src.tar.gz.asc) [SHA512](https://www.apache.org/dist/incubator/doris/0.12.0-incubating/apache-doris-0.12.0-incubating-src.tar.gz.sha512)) |
| 0.11.0 | 2019-11-29 | [Source](https://www.apache.org/dyn/closer.cgi?path=/incubator/doris/0.11.0-incubating/apache-doris-0.11.0-incubating-src.tar.gz) ([Signature](https://www.apache.org/dist/incubator/doris/0.11.0-incubating/apache-doris-0.11.0-incubating-src.tar.gz.asc) [SHA512](https://www.apache.org/dist/incubator/doris/0.11.0-incubating/apache-doris-0.11.0-incubating-src.tar.gz.sha512)) |
| 0.10.0 | 2019-07-02 | [Source](https://www.apache.org/dyn/closer.cgi?path=/incubator/doris/0.10.0-incubating/apache-doris-0.10.0-incubating-src.tar.gz) ([Signature](https://www.apache.org/dist/incubator/doris/0.10.0-incubating/apache-doris-0.10.0-incubating-src.tar.gz.asc) [SHA512](https://www.apache.org/dist/incubator/doris/0.10.0-incubating/apache-doris-0.10.0-incubating-src.tar.gz.sha512)) |
diff --git a/docs/zh-CN/community/release-process.md b/docs/zh-CN/community/release-process.md
index d828df3..f086141 100644
--- a/docs/zh-CN/community/release-process.md
+++ b/docs/zh-CN/community/release-process.md
@@ -36,16 +36,21 @@ Apache 的发布必须至少是 IPMC 成员，拥有 apache 邮箱的committer
2. 创建分支用于发布
3. 清理 issue
4. 将必要的 Patch 合并到发布的分支
-3. 社区发布投票流程
+3. 验证分支
+ 1. QA 稳定性测试
+ 2. 验证编译镜像正确性
+ 3. 准备 Release Nodes
+4. 社区发布投票流程
1. 将 tag 打包，签名并上传到[Apache Dev svn 仓库](https://dist.apache.org/repos/dist/dev/incubator/doris)
2. 在 [Doris 社区](dev@doris.apache.org)发起投票
3. 投票通过后，在Doris社区发 Result 邮件
4. 在 [Incubator 社区](general@incubator.apache.org) 发起新一轮投票
5. 发 Result 邮件到 general@incubator.apache.org
-4. 完成工作
+5. 完成工作
1. 上传签名的软件包到 [Apache release repo](https://dist.apache.org/repos/dist/release/incubator/doris)，并生成相关链接
- 2. 准备 release note 并发 Announce 邮件到 general@incubator.apache.org
- 3. 在 Doris 官网和 github 发布下载链接
+ 2. 在 Doris 官网和 github 发布下载链接
+ 3. 发送 Announce 邮件到 general@incubator.apache.org
+
## 准备环境
@@ -164,9 +169,13 @@ Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit? o
其中 Real name 需保持和 id.apache.org 中显示的 id 一致。
Email address 为 apache 的邮箱。
+输入 passphrase, 一共要输入两遍，超过8个字符即可。
+
+**这里的秘钥一定要记住，后面签名的时候会用到**
+
##### 查看和输出
-第一行显示公钥文件名（pubring.gpg），第二行显示公钥特征（4096位，Hash字符串和生成时间），第三行显示"用户ID"，第四行显示私钥特征。
+第一行显示公钥文件名（pubring.gpg），第二行显示公钥特征（4096位，Hash字符串和生成时间），第三行显示"用户ID"，注释，邮件，第四行显示私钥特征。
```
$ gpg --list-keys
@@ -185,6 +194,7 @@ gpg --armor --output public-key.txt --export [用户ID]
```
$ gpg --armor --output public-key.txt --export xxx-yyy
+文件‘public-key.txt’已存在。 是否覆盖？(y/N)y
$ cat public-key.txt
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v2.0.22 (GNU/Linux)
@@ -271,6 +281,32 @@ $ git checkout -b branch-0.9
在发布等待过程中，可能会有比较重要的Patch合入，如果社区有人说要有重要的Bug需要合入，那么 Release Manager 需要评估并将重要的Patch合入到发布分支中。
+## 验证分支
+
+### QA 稳定性测试
+
+将打好的分支交给 QA 同学进行稳定性测试。如果在测试过程中，出现需要修复的问题，则如果在测试过程中，出现需要修复的问题，待修复好后，需要将修复问题的 PR 合入到待发版本的分支中。
+
+待整个分支稳定后，才能准备发版本。
+
+### 验证编译镜像正确性
+
+1. 下载编译镜像
+
+ ```
+ docker pull apachedoris/doris-dev:build-env-1.2
+ ```
+
+2. 使用官方文档编译新分支，编译方式见[Docker 开发镜像编译](http://doris.apache.org/master/zh-CN/installing/compilation.html)
+
+ 进入镜像后，编译可能需要大概3~4小时左右，请耐心等待。
+
+ 如果编译中缺少某些三方库导致编译失败，则说明编译镜像需要更新。
+
+3. 重新打编译镜像
+
+### 准备 Release Nodes
+
## 社区发布投票流程
### 打 tag
@@ -335,7 +371,7 @@ svn add 0.11.0-rc1
svn commit -m "Add 0.11.0-rc1"
```
-### 发社区投票邮件
+### 发邮件到社区 dev@doris.apache.org 进行投票
[VOTE] Release Apache Doris 0.9.0-incubating-rc01
@@ -544,14 +580,57 @@ xxx
第一次发布的话 KEYS 文件也需要拷贝过来。然后add到svn release 下。
```
+add 成功后就可以在下面网址上看到你发布的文件
+https://dist.apache.org/repos/dist/release/incubator/doris/0.xx.0-incubating/
-https://dist.apache.org/repos/dist/release/incubator/doris/0.9.0-incubating/
-
-最终能在 apache 官网看到：
+稍等一段时间后，能在 apache 官网看到：
http://www.apache.org/dist/incubator/doris/0.9.0-incubating/
```
+### 在 Doris 官网和 github 发布链接
+
+#### 创建下载链接
+
+下载链接：
+http://www.apache.org/dyn/closer.cgi?filename=incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz&action=download
+
+wget --trust-server-names "https://www.apache.org/dyn/mirrors/mirrors.cgi?action=download&filename=incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz"
+
+原始位置:
+https://www.apache.org/dist/incubator/doris/0.9.0-incubating/
+
+http://www.apache.org/dyn/closer.cgi/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz
+
+源码包（source package）:
+http://www.apache.org/dyn/closer.cgi/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz
+
+ASC:
+http://archive.apache.org/dist/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz.asc
+
+sha512:
+http://archive.apache.org/dist/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz.sha512
+
+KEYS:
+http://archive.apache.org/dist/incubator/doris/KEYS
+
+refer to: <http://www.apache.org/dev/release-download-pages#closer>
+
+#### 准备 release note
+
+需要修改如下两个地方：
+
+1、Github 的 release 页面
+
+```
+https://github.com/apache/incubator-doris/releases/tag/0.9.0-rc01
+```
+
+2、Doris 官网下载页面
+
+```
+http://doris.apache.org/downloads.html
+```
### 发 Announce 邮件到 general@incubator.apache.org
Title:
@@ -577,7 +656,7 @@ We are pleased to announce the release of Apache Doris 0.9.0-incubating.
Apache Doris (incubating) is an MPP-based interactive SQL data warehousing for reporting and analysis.
The release is available at:
-http://doris.apache.org/downloads.html
+http://doris.apache.org/master/zh-CN/downloads/downloads.html
Thanks to everyone who has contributed to this release, and the release note can be found here:
https://github.com/apache/incubator-doris/releases
@@ -609,47 +688,5 @@ including this work. For the current status of this project through the Apache I
visit: https://incubator.apache.org/projects/doris.html
```
-### 在 Doris 官网和 github 发布链接
-
-#### 创建下载链接
-
-下载链接：
-http://www.apache.org/dyn/closer.cgi?filename=incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz&action=download
-
-wget --trust-server-names "https://www.apache.org/dyn/mirrors/mirrors.cgi?action=download&filename=incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz"
-
-原始位置:
-https://www.apache.org/dist/incubator/doris/0.9.0-incubating/
-http://www.apache.org/dyn/closer.cgi/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz
-
-源码包（source package）:
-http://www.apache.org/dyn/closer.cgi/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz
-
-ASC:
-http://archive.apache.org/dist/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz.asc
-
-sha512:
-http://archive.apache.org/dist/incubator/doris/0.9.0-incubating/apache-doris-0.9.0-incubating-src.tar.gz.sha512
-
-KEYS:
-http://archive.apache.org/dist/incubator/doris/KEYS
-
-refer to: <http://www.apache.org/dev/release-download-pages#closer>
-
-#### 准备 release note
-
-需要修改如下两个地方：
-
-1、Github 的 release 页面
-
-```
-https://github.com/apache/incubator-doris/releases/tag/0.9.0-rc01
-```
-
-2、Doris 官网下载页面
-
-```
-http://doris.apache.org/downloads.html
-```
diff --git a/docs/zh-CN/downloads/downloads.md b/docs/zh-CN/downloads/downloads.md
index a2bf305..dac772f 100644
--- a/docs/zh-CN/downloads/downloads.md
+++ b/docs/zh-CN/downloads/downloads.md
@@ -11,6 +11,7 @@
| 版本 | 发布日期 | 从镜像网站下载 |
|---|---|---|
+| 0.13.0 | 2020-10-24 | [Source](https://www.apache.org/dyn/closer.cgi?path=/incubator/doris/0.13.0-incubating/apache-doris-0.13.0-incubating-src.tar.gz) ([Signature]3https://www.apache.org/dist/incubator/doris/0.13.0-incubating/apache-doris-0.13.0-incubating-src.tar.gz.asc) [SHA512](https://www.apache.org/dist/incubator/doris/0.13.0-incubating/apache-doris-0.13.0-incubating-src.tar.gz.sha512))|
| 0.12.0 | 2020-04-24 | [Source](https://www.apache.org/dyn/closer.cgi?path=/incubator/doris/0.12.0-incubating/apache-doris-0.12.0-incubating-src.tar.gz) ([Signature](https://www.apache.org/dist/incubator/doris/0.12.0-incubating/apache-doris-0.12.0-incubating-src.tar.gz.asc) [SHA512](https://www.apache.org/dist/incubator/doris/0.12.0-incubating/apache-doris-0.12.0-incubating-src.tar.gz.sha512)) |
| 0.11.0 | 2019-11-29 | [Source](https://www.apache.org/dyn/closer.cgi?path=/incubator/doris/0.11.0-incubating/apache-doris-0.11.0-incubating-src.tar.gz) ([Signature](https://www.apache.org/dist/incubator/doris/0.11.0-incubating/apache-doris-0.11.0-incubating-src.tar.gz.asc) [SHA512](https://www.apache.org/dist/incubator/doris/0.11.0-incubating/apache-doris-0.11.0-incubating-src.tar.gz.sha512)) |
| 0.10.0 | 2019-07-02 | [Source](https://www.apache.org/dyn/closer.cgi?path=/incubator/doris/0.10.0-incubating/apache-doris-0.10.0-incubating-src.tar.gz) ([Signature](https://www.apache.org/dist/incubator/doris/0.10.0-incubating/apache-doris-0.10.0-incubating-src.tar.gz.asc) [SHA512](https://www.apache.org/dist/incubator/doris/0.10.0-incubating/apache-doris-0.10.0-incubating-src.tar.gz.sha512)) |
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For additional commands, e-mail: commits-help@doris.apache.org