Release Doris Core

Doris Core refers to the content published in https://github.com/apache/incubator-doris.

Preparing for release

First, see the release preparation documentation for release preparation.

Preparing a branch

You need to create a new branch before releasing. For example.

  1. $ git checkout -b branch-0.9

This branch should be more fully tested to make features available, bugs converged, and important bugs fixed. This process requires waiting for the community to see if there are any necessary patches that need to be merged in for this release, and if so, cherry-picking it to the release branch.

Clean up issues

Go through all the issues that belong to this release, close the ones that are done, and if they can’t be done, defer them to a later release.

Merge necessary patches

If someone in the community says there are important bugs that need to be merged in, then the Release Manager needs to evaluate and merge the important patches into the release branch.

Validation branch

Stability testing

Pass the batched branch to the QA students for stability testing. If during the testing process, there are issues that need to be fixed, then if during the testing process, there are issues that need to be fixed, then after they are fixed, the PRs that fix the issues need to be merged into the branch of the pending release.

Only after the whole branch is stable, can you prepare to release the version.

Compile verification

Please refer to the compilation documentation for compilation to ensure that the source code is compiled correctly.

Prepare Release Nodes

Community Posting Voting Process

Tagging

Once the above branch is more stable, you can tag this branch. Remember to modify the build_version variable in gensrc/script/gen_build_version.sh when creating the tag. For example build_version="0.10.0-release"

Example:

  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

Package, sign and upload

For the following steps, you also need to log in to the user account directly through a terminal such as SecureCRT, not through su - user or ssh, otherwise the password input box will not be displayed and an error will be reported.

  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

Then upload the packaged content to the svn repository by first downloading the svn library at:

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

Organize all the previously obtained files into the following svn path:

  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

Upload these file:

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

Email the community at dev@doris.apache.org to vote

[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 wiki:
  26. https://github.com/apache/incubator-doris/wiki/How-to-verify-Apache-Release
  27. https://wiki.apache.org/incubator/IncubatorReleaseChecklist
  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. Best Regards,
  35. xxx
  37. ----
  38. DISCLAIMER: 
  39. Apache Doris (incubating) is an effort undergoing incubation at The
  40. Apache Software Foundation (ASF), sponsored by the Apache Incubator PMC.
  42. Incubation is required of all newly accepted
  43. projects until a further review indicates that the
  44. infrastructure, communications, and decision making process have
  45. stabilized in a manner consistent with other successful ASF
  46. projects.
  48. While incubation status is not necessarily a reflection
  49. of the completeness or stability of the code, it does indicate
  50. that the project has yet to be fully endorsed by the ASF.

After the vote is approved, send the Result email

[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

Email general@incubator.apache.org to vote

If not an incubator program, please skip

[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.

The thread link for the email can be found here.

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

Send Result email to general@incubator.apache.org

If not an incubator project, please skip

[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

Completing the release

Please refer to the Release Completion document to complete the release process.