Skip to content

Release Runbook

Jump to bottom
Dianjin Wang edited this page Jul 9, 2026 · 2 revisions

(Draft, still WIP)

Prepare GPG KEY (Optional, only for the first time setup)

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 discussion about the release

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.

Git tag

# 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

Generate the artifacts

Verify on your local machine

Send to Apache Cloudberry Mailing list

  • 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

Send to Apache Incubator Mailing list

RC1

  • 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

RC2

general@incubator.apache.org

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

Remove the old release

svn del -m "Archiving release 2.0.0" https://dist.apache.org/repos/dist/release/incubator/cloudberry/2.0.0-incubating/

Announce new Release

  • 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

Clone this wiki locally