发布 Doris Core

Doris Core 指发布 https://github.com/apache/incubator-doris 中的内容。

准备发布

首先，请参阅 发版准备 文档进行发版准备。

准备分支

发布前需要先新建一个分支。例如：

  1. $ git checkout -b branch-0.9

这个分支要进行比较充分的测试，使得功能可用，bug收敛，重要bug都得到修复。 这个过程需要等待社区，看看是否有必要的patch需要在这个版本合入，如果有，需要把它 cherry-pick 到发布分支。

清理issue

将属于这个版本的所有 issue 都过一遍，关闭已经完成的，如果没法完成的，推迟到更晚的版本。

合并必要的Patch

在发布等待过程中，可能会有比较重要的Patch合入，如果社区有人说要有重要的Bug需要合入，那么 Release Manager 需要评估并将重要的Patch合入到发布分支中。

验证分支

稳定性测试

将打好的分支交给 QA 同学进行稳定性测试。如果在测试过程中，出现需要修复的问题，则如果在测试过程中，出现需要修复的问题，待修复好后，需要将修复问题的 PR 合入到待发版本的分支中。

待整个分支稳定后，才能准备发版本。

编译验证

请参阅编译文档进行编译，以确保源码编译正确性。

准备 Release Nodes

社区发布投票流程

打 tag

当上述分支已经比较稳定后，就可以在此分支上打 tag。 记得在创建 tag 时，修改 gensrc/script/gen_build_version.sh 中的 build_version 变量。如 build_version="0.10.0-release"

例如：

  1. $ git checkout branch-0.9
  2. $ git tag -a 0.9.0-rc01 -m "0.9.0 release candidate 01"
  3. $ git push origin 0.9.0-rc01
  4. Counting objects: 1, done.
  5. Writing objects: 100% (1/1), 165 bytes | 0 bytes/s, done.
  6. Total 1 (delta 0), reused 0 (delta 0)
  7. To git@github.com:apache/incubator-doris.git
  8.  * [new tag]         0.9.0-rc01 -> 0.9.0-rc01
  10. $ git tag

打包、签名上传

如下步骤，也需要通过 SecureCRT 等终端直接登录用户账户，不能通过 su - user 或者 ssh 转，否则密码输入 box 会显示不出来而报错。

  1. $ git checkout 0.9.0-rc01
  3. $ git archive --format=tar 0.9.0-rc01 --prefix=apache-doris-0.9.0-incubating-src/ | gzip > apache-doris-0.9.0-incubating-src.tar.gz
  5. $ gpg -u xxx@apache.org --armor --output apache-doris-0.9.0-incubating-src.tar.gz.asc --detach-sign apache-doris-0.9.0-incubating-src.tar.gz
  7. $ gpg --verify apache-doris-0.9.0-incubating-src.tar.gz.asc apache-doris-0.9.0-incubating-src.tar.gz
  9. $ sha512sum apache-doris-0.9.0-incubating-src.tar.gz > apache-doris-0.9.0-incubating-src.tar.gz.sha512
  11. $ sha512sum --check apache-doris-0.9.0-incubating-src.tar.gz.sha512

然后将打包的内容上传到svn仓库中，首先下载 svn 库：

  1. svn co https://dist.apache.org/repos/dist/dev/incubator/doris/

将之前得到的全部文件组织成以下svn路径

  1. ./doris/
  2. |-- 0.11.0-rc1
  3. |   |-- apache-doris-0.11.0-incubating-src.tar.gz
  4. |   |-- apache-doris-0.11.0-incubating-src.tar.gz.asc
  5. |   `-- apache-doris-0.11.0-incubating-src.tar.gz.sha512
  6. `-- KEYS

上传这些文件

  1. svn add 0.11.0-rc1
  2. svn commit -m "Add 0.11.0-rc1"

发邮件到社区 dev@doris.apache.org 进行投票

[VOTE] Release Apache Doris 0.9.0-incubating-rc01

  1. Hi all,
  3. Please review and vote on Apache Doris 0.9.0-incubating-rc01 release.
  5. The release candidate has been tagged in GitHub as 0.9.0-rc01, available
  6. here:
  7. https://github.com/apache/incubator-doris/releases/tag/0.9.0-rc01
  9. Release Notes are here:
  10. https://github.com/apache/incubator-doris/issues/1891
  12. Thanks to everyone who has contributed to this release.
  14. The artifacts (source, signature and checksum) corresponding to this release
  15. candidate can be found here:
  16. https://dist.apache.org/repos/dist/dev/incubator/doris/0.9/0.9.0-rc1/
  18. This has been signed with PGP key 33DBF2E0, corresponding to
  19. lide@apache.org.
  20. KEYS file is available here:
  21. https://downloads.apache.org/incubator/doris/KEYS
  22. It is also listed here:
  23. https://people.apache.org/keys/committer/lide.asc
  25. To verify and build, you can refer to following link:
  26. http://doris.incubator.apache.org/community/release-and-verify/release-verify.html
  28. The vote will be open for at least 72 hours.
  29. [ ] +1 Approve the release
  30. [ ] +0 No opinion
  31. [ ] -1 Do not release this package because ...
  33. Best Regards,
  34. xxx
  36. ----
  37. DISCLAIMER: 
  38. Apache Doris (incubating) is an effort undergoing incubation at The
  39. Apache Software Foundation (ASF), sponsored by the Apache Incubator PMC.
  41. Incubation is required of all newly accepted
  42. projects until a further review indicates that the
  43. infrastructure, communications, and decision making process have
  44. stabilized in a manner consistent with other successful ASF
  45. projects.
  47. While incubation status is not necessarily a reflection
  48. of the completeness or stability of the code, it does indicate
  49. that the project has yet to be fully endorsed by the ASF.

投票通过后，发 Result 邮件

[Result][VOTE] Release Apache Doris 0.9.0-incubating-rc01

  1. Thanks to everyone, and this vote is now closed.
  3. It has passed with 4 +1 (binding) votes and no 0 or -1 votes.
  5. Binding:
  6. +1 Zhao Chun
  7. +1 xxx
  8. +1 Li Chaoyong
  9. +1 Mingyu Chen
  11. Best Regards,
  12. xxx

发邮件到 general@incubator.apache.org 进行投票

如非孵化器项目，请跳过

[VOTE] Release Apache Doris 0.9.0-incubating-rc01

  1. Hi all,
  3. Please review and vote on Apache Doris 0.9.0-incubating-rc01 release.
  5. Apache Doris is an MPP-based interactive SQL data warehousing for reporting and analysis.
  7. The Apache Doris community has voted on and approved this release:
  8. https://lists.apache.org/thread.html/d70f7c8a8ae448bf6680a15914646005c6483564464cfa15f4ddc2fc@%3Cdev.doris.apache.org%3E
  10. The vote result email thread:
  11. https://lists.apache.org/thread.html/64d229f0ba15d66adc83306bc8d7b7ccd5910ecb7e842718ce6a61da@%3Cdev.doris.apache.org%3E
  13. The release candidate has been tagged in GitHub as 0.9.0-rc01, available here:
  14. https://github.com/apache/incubator-doris/releases/tag/0.9.0-rc01
  16. There is no CHANGE LOG file because this is the first release of Apache Doris.
  17. Thanks to everyone who has contributed to this release, and there is a simple release notes can be found here:
  18. https://github.com/apache/incubator-doris/issues/406
  20. The artifacts (source, signature and checksum) corresponding to this release candidate can be found here:
  21. https://dist.apache.org/repos/dist/dev/incubator/doris/0.9/0.9.0-rc01/
  23. This has been signed with PGP key 33DBF2E0, corresponding to lide@apache.org.
  24. KEYS file is available here:
  25. https://downloads.apache.org/incubator/doris/KEYS
  26. It is also listed here:
  27. https://people.apache.org/keys/committer/lide.asc
  29. The vote will be open for at least 72 hours.
  30. [ ] +1 Approve the release
  31. [ ] +0 No opinion
  32. [ ] -1 Do not release this package because ...
  34. To verify and build, you can refer to following instruction:
  36. Firstly, you must be install and start docker service, and then you could build Doris as following steps:
  38. Step1: Pull the docker image with Doris building environment
  39. $ docker pull apache/incubator-doris:build-env-1.3.1
  40. You can check it by listing images, its size is about 3.28GB.
  42. Step2: Run the Docker image
  43. You can run image directly:
  44. $ docker run -it apache/incubator-doris:build-env-1.3.1
  46. Step3: Download Doris source
  47. Now you should in docker environment, and you can download Doris source package.
  48. (If you have downloaded source and it is not in image, you can map its path to image in Step2.)
  49. $ wget https://dist.apache.org/repos/dist/dev/incubator/doris/0.9/0.9.0-rc01/apache-doris-0.9.0.rc01-incubating-src.tar.gz
  51. Step4: Build Doris
  52. Now you can decompress and enter Doris source path and build Doris.
  53. $ tar zxvf apache-doris-0.9.0.rc01-incubating-src.tar.gz
  54. $ cd apache-doris-0.9.0.rc01-incubating-src
  55. $ sh build.sh
  57. Best Regards,
  58. xxx
  60. ----
  61. DISCLAIMER: 
  62. Apache Doris (incubating) is an effort undergoing incubation at The
  63. Apache Software Foundation (ASF), sponsored by the Apache Incubator PMC.
  65. Incubation is required of all newly accepted
  66. projects until a further review indicates that the
  67. infrastructure, communications, and decision making process have
  68. stabilized in a manner consistent with other successful ASF
  69. projects.
  71. While incubation status is not necessarily a reflection
  72. of the completeness or stability of the code, it does indicate
  73. that the project has yet to be fully endorsed by the ASF.

邮件的 thread 连接可以在这里找到：

https://lists.apache.org/list.html?dev@doris.apache.org

发 Result 邮件到 general@incubator.apache.org

如非孵化器项目，请跳过

[RESULT][VOTE] Release Apache Doris 0.9.0-incubating-rc01

  1. Hi,
  3. Thanks to everyone, and the vote for releasing Apache Doris 0.9.0-incubating-rc01 is now closed.
  5. It has passed with 4 +1 (binding) votes and no 0 or -1 votes.
  7. Binding:
  8. +1 Willem Jiang
  9. +1 Justin Mclean
  10. +1 ShaoFeng Shi
  11. +1 Makoto Yui
  13. The vote thread:
  14. https://lists.apache.org/thread.html/da05fdd8d84e35de527f27200b5690d7811a1e97d419d1ea66562130@%3Cgeneral.incubator.apache.org%3E
  16. Best Regards,
  17. xxx

完成发布

请参阅 完成发布 文档完成所有发布流程。