-
Notifications
You must be signed in to change notification settings - Fork 220
Release Runbook
Dianjin Wang edited this page Jul 9, 2026
·
2 revisions
(Draft, still WIP)
Please follow this the page GPG Key Setup to create your GPG key and upload the Apache. Each release manager only creates a GPG KEY for the first release, which can be reused for subsequent releases.
Start a discussion about the next release via sending email to: dev@cloudberry.apache.org:
- Subject:
[DISCUSS] Release Apache Cloudberry ${release_version} - Body:
Hello, Apache Cloudberry Community,
This is a call for a discussion to release Apache Cloudberry version x.x.0. I would like to take the Release manager for this release.
Please leave your comments here about this release plan. We will bump the version in repo and start the release process after the discussion.
Thanks,
XXX
If the discussion goes positive, you will need to prepare the release artifiacts.
# Clone the source
git clone https://github.com/apache/cloudberry.git
# Create the tag
git tag -a x.x.0 2ffc7e60dd4xxxxx -m "Stamp Apache Cloudberry (Incubating) x.x.0"
# verify the tag info
git log --oneline
git cat-file -p x.x.0
git describe
# Push to the repo
git push origin x.x.0- Subject:
[VOTE] Release Apache Cloudberry (Incubating) x.x.0-rc1 - Body:
Hi all,
I would like to call a VOTE to release Apache Cloudberry (Incubating) x.x.0-rc1.
## Release Candidate Artifacts
This vote covers the source release artifacts for Apache Cloudberry (Incubating) x.x.0-rc1, including the main Cloudberry project and the two components cloudberry-backup and cloudberry-pxf.
Staged release artifacts:
https://dist.apache.org/repos/dist/dev/incubator/cloudberry/x.x.0-incubating-rc1/
Git tag & commit for the release:
- cloudberry
https://github.com/apache/cloudberry/tree/x.x.0-incubating-rc1
https://github.com/apache/cloudberry/commit/bdf90c5xxxxxxx
- cloudberry-backup
https://github.com/apache/cloudberry-backup/tree/x.x.0-incubating-rc1
https://github.com/apache/cloudberry-backup/commit/c909fbexxxxxx
- cloudberry-pxf
https://github.com/apache/cloudberry-pxf/tree/x.x.0-incubating-rc1
https://github.com/apache/cloudberry-pxf/commit/59dceddxxxxxxxxxx
KEYS file:
https://downloads.apache.org/incubator/cloudberry/KEYS
GPG signature key: 9A36AA272348A20XXXXXXXXXX
The GPG user ID(s): Dianjin Wang <xxxxx@apache.org>
## How to Vote
Please review the release and cast your vote below. If you are a PPMC member, please indicate whether your vote is binding. Also, that would be better to list the items you checked in your reply - it shows what you vote for.
[ ] +1 Approve the release
[ ] 0 No opinion
[ ] -1 Disapprove (please explain why)
The vote is open for at least 72 hours and will close no earlier than March 8, 2026 at 08:00 UTC.
## Checklist for reference:
[ ] Download links are valid and accessible.
[ ] GPG signature is valid for the release artifact using the KEYS file.
[ ] SHA512 checksums are correct and verified.
[ ] Source release artifact filename includes "incubating".
[ ] LICENSE, NOTICE, and DISCLAIMER files exist and are accurate.
[ ] No unexpected binary files in the source release.
[ ] All source files have appropriate ASF headers (excluding generated files and legacy files).
[ ] Build completes successfully from source with clear instructions.
More detail checklist, please refer to: https://github.com/apache/cloudberry/wiki/Source-Release-Checklist
Build/Install guides (for reference):
- cloudberry: https://cloudberry.apache.org/docs/deployment/quick-build#for-apache-cloudberry-XXX
- cloudberry-pxf: https://github.com/apache/cloudberry-pxf/blob/x.x.0-incubating-rc1/README.md
- cloudberry-backup: https://github.com/apache/cloudberry-backup/blob/x.x.0-incubating-rc1/README.md
## GPG Signature and SHA512 checksums Verification Instructions
Please refer to our step-by-step guide: https://cloudberry.apache.org/releases/#verifying-releases
## About Convenience Binaries
After this source release vote passes and the release is published, we plan to provide optional convenience binary packages via GitHub Releases for easier testing. These binaries are not part of this vote and are not ASF release artifacts.
Thanks for reviewing and voting!
Best,
Dianjin Wang
- Subject:
[VOTE] Release Apache Cloudberry (Incubating) x.x.0-rc1 - Body:
Hello Incubator Community,
This is a call for vote to release Apache Cloudberry (Incubating) x.x.0-rc1.
The Apache Cloudberry (Incubating) community has voted to release version x.x.0-rc1. We now kindly request the Incubator PMC's approval.
Community vote thread:
https://lists.apache.org/thread/xxxxxxx
Vote result thread:
https://lists.apache.org/thread/xxxxxxx
Release candidate artifacts:
https://dist.apache.org/repos/dist/dev/incubator/cloudberry/x.x.x-incubating-rc1/
Git tag & commit for the release:
- https://github.com/apache/cloudberry/tree/x.x.0-incubating-rc1 (bdf90c5)
- https://github.com/apache/cloudberry-backup/tree/x.x.0-incubating-rc1 (c909fbe)
- https://github.com/apache/cloudberry-pxf/tree/x.x.0-incubating-rc1 (59dcedd)
The artifacts have been signed with key [9A36AA272348A207E19xxxxxxxxx], corresponding to xxxx@apache.org, available here: https://downloads.apache.org/incubator/cloudberry/KEYS
Please vote on releasing this candidate as Apache Cloudberry (Incubating) x.x.0.
[ ] +1 Approve the release
[ ] 0 No opinion
[ ] -1 Disapprove (please explain why)
This vote will be open for at least 72 hours.
Checklist for reference:
[ ] Download links are valid and accessible.
[ ] GPG signature is valid for the release artifact using the KEYS file.
[ ] SHA512 checksums are correct and verified.
[ ] Source release artifact filename includes "incubating".
[ ] LICENSE, NOTICE, and DISCLAIMER files exist and are accurate.
[ ] No unexpected binary files in the source release.
[ ] All source files have appropriate ASF headers (excluding generated
files and legacy files).
[ ] Build completes successfully from source with clear instructions.
More detailed checklist, please refer to:
https://github.com/apache/cloudberry/wiki/Source-Release-Checklist
Build/Install guides (for reference):
- cloudberry: https://cloudberry.apache.org/docs/deployment/quick-build#for-apache-cloudberry-XX0
- cloudberry-pxf:
https://github.com/apache/cloudberry-pxf/blob/x.x.0-incubating-rc1/README.md
- cloudberry-backup:
https://github.com/apache/cloudberry-backup/blob/x.x.0-incubating-rc1/README.md
To learn more about Apache Cloudberry (incubating) , please see https://cloudberry.apache.org/
Thanks,
Dianjin Wang
On behalf of Apache Cloudberry (Incubating) community
- Subject:
[RESULT] [VOTE] Release Apache Cloudberry (Incubating) 2.1.0-rc1 - Body:
Hello Incubator Community,
The vote to release Apache Cloudberry (Incubating) x.x.0-rc1 has passed with 3 +1 binding votes, 2 +1 non-binding, no +0 or -1 votes.
+1 binding:
- XXXX (binding)
- XXXX (binding)
- XXXX (binding)
+1 Non-binding:
- XXXX (non-binding)
- XXXX (non-binding)
Vote thread:
https://lists.apache.org/thread/xxxxxx
Thanks for reviewing and voting for our release candidate.
We will proceed with publishing the approved artifacts and sending out the
announcement soon.
svn del -m "Archiving release 2.0.0" https://dist.apache.org/repos/dist/release/incubator/cloudberry/2.0.0-incubating/- to:
annouce@apache.org - cc:
general@incubator.apache.org,dev@cloudberry.apache.org - subject:
[ANNOUNCE] Apache Cloudberry (Incubating) x.x.0 released - body:
The Apache Cloudberry (Incubating) community is pleased to announce the release of Apache Cloudberry (Incubating) version x.x.0.
Apache Cloudberry (Incubating) is a Massively Parallel Processing (MPP)
database for large-scale data analytics, derived from PostgreSQL and the
last open-source version of Greenplum Database. It is designed to support
both on-premise and cloud deployments, providing a scalable foundation
for data warehousing and advanced analytics.
This release covers the main Cloudberry project and the
two components cloudberry-backup and cloudberry-pxf.
Download and verification:
https://cloudberry.apache.org/releases
Changelog:
https://cloudberry.apache.org/releases/x.x.0-incubating
For documentation, visit:
https://cloudberry.apache.org/docs/
Website: https://cloudberry.apache.org
Resources:
- Repository: https://github.com/apache/cloudberry
- Discussions: https://github.com/apache/cloudberry/discussions
- Issue tracker: https://github.com/apache/cloudberry/issues
- Mailing list: https://lists.apache.org/list.html?dev@cloudberry.apache.org
Thanks to everyone who participated in the development and release!
Apache Cloudberry is an effort undergoing incubation at the Apache
Software Foundation (ASF), sponsored by the Apache Incubator PMC.
Incubation is required of all newly accepted projects until a review by
the Incubator PMC demonstrates that the project has met the ASF’s
requirements for community and process. While incubation status is not
necessarily a reflection of the project’s stability or readiness for
production, it does indicate that the project is working towards
compliance with ASF processes and governance.
XXX XX
On behalf of Apache Cloudberry (Incubating) Team