Release Doris Core

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.