add release check doc

apache · Jan 2, 2020 · 9e5f4c6 · 9e5f4c6
1 parent 64d5ed1
commit 9e5f4c6
Showing 1 changed file with 161 additions and 0 deletions.
diff --git a/docs/Development-ReleaseCheck.md b/docs/Development-ReleaseCheck.md
@@ -0,0 +1,161 @@
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+-->
+
+# 版本发布-检查投票流程
+
+## 下载投票的 版本/rc 下的所有内容
+
+https://dist.apache.org/repos/dist/dev/incubator/iotdb/
+
+## 下载公钥
+
+https://dist.apache.org/repos/dist/dev/incubator/iotdb/KEYS
+
+最下边有 Release Manager (RM) 的公钥，把对应的下边这段复制到一个文本文件中，起个名叫 ```key.asc```
+
+```
+-----BEGIN PGP PUBLIC KEY BLOCK-----
+Version: GnuPG v2
+...
+-----END PGP PUBLIC KEY BLOCK-----
+```
+
+导入 RM 的公钥到自己电脑
+
+安装 gpg/gpg2
+
+```
+gpg/gpg2 --import key.asc
+```
+
+## 验证源码发布版
+
+* （孵化阶段）验证是否名字中有 ```incubating```
+
+* 验证是否有 DISCLAIMER、NOTICE、LICENSE，以及内容是否正确。
+
+* 验证 README、RELEASE_NOTES
+
+* 验证 header
+
+```
+mvn -B apache-rat:check
+```
+
+* 验证签名和哈希值
+
+```
+gpg2 --verify apache-iotdb-0.9.0-incubating-source-release.zip.asc apache-iotdb-0.9.0-incubating-source-release.zip
+
+出现 Good Singnature 
+
+shasum -a512 apache-iotdb-0.9.0-incubating-source-release.zip
+
+和对应的 .sha512 对比，一样就可以。
+```
+
+* 验证编译
+
+```
+mvnw.sh install
+
+应该最后全 SUCCESS
+```
+
+## 验证二进制发布版
+
+* （孵化阶段）验证是否名字中有 ```incubating```
+
+* 验证是否有 DISCLAIMER、NOTICE、LICENSE，以及内容是否正确。
+
+* 验证 README、RELEASE_NOTES
+
+* 验证签名和哈希值
+
+```
+gpg2 --verify apache-iotdb-0.9.0-incubating-bin.zip.asc apache-iotdb-0.9.0-incubating-bin.zip
+
+出现 Good Singnature 
+
+shasum -a512 apache-iotdb-0.9.0-incubating-bin.zip
+
+和对应的 .sha512 对比，一样就可以。
+```
+
+* 验证是否能启动以及示例语句是否正确执行
+
+```
+./sbin/start-server.sh
+
+./sbin/start-client.sh
+
+SET STORAGE GROUP TO root.turbine;
+CREATE TIMESERIES root.turbine.d1.s0 WITH DATATYPE=DOUBLE, ENCODING=GORILLA;
+insert into root.turbine.d1(timestamp,s0) values(1,1);
+insert into root.turbine.d1(timestamp,s0) values(2,2);
+insert into root.turbine.d1(timestamp,s0) values(3,3);
+select * from root;
+
+打印如下内容：
++-----------------------------------+------------------+
+|                               Time|root.turbine.d1.s0|
++-----------------------------------+------------------+
+|      1970-01-01T08:00:00.001+08:00|               1.0|
+|      1970-01-01T08:00:00.002+08:00|               2.0|
+|      1970-01-01T08:00:00.003+08:00|               3.0|
++-----------------------------------+------------------+
+
+```
+
+## 示例邮件
+
+验证通过之后可以发邮件了
+
+```
+Hi,
+
++1 (PMC could binding)
+
+The source release:
+Incubating in name [ok]
+Has DISCLAIMER [ok]
+LICENSE and NOTICE [ok]
+signatures and hashes [ok]
+All files have ASF header [ok]
+could compile from source: ./mvnw.sh clean install [ok]
+
+The binary distribution:
+Incubating in name [ok]
+Has DISCLAIMER [ok]
+LICENSE and NOTICE [ok]
+signatures and hashes [ok]
+Could run with the following statements [ok]
+
+SET STORAGE GROUP TO root.turbine;
+CREATE TIMESERIES root.turbine.d1.s0 WITH DATATYPE=DOUBLE, ENCODING=GORILLA;
+insert into root.turbine.d1(timestamp,s0) values(1,1);
+insert into root.turbine.d1(timestamp,s0) values(2,2);
+insert into root.turbine.d1(timestamp,s0) values(3,3);
+select * from root;
+
+Thanks,
+xxx
+```