This article contains all the steps required to release Apache Geode.
brew install svn]
To verify
|
A major release is a version x.0.0 and allows/implies breaking changes, removal of deprecated methods, changes to minimum JDK, etc.
A minor release is a version x.y.0 where y > 0 and typically allows/implies new features.
A patch release is a version x.y.n where n > 0 and should contain a limited number of critical fixes only.
Except where noted, all instructions in this guide apply to all three types of releases. Dev list proposals for patch releases may be made at any time since the branch already exists, however some planning ahead is helpful for major or minor releases. since it is usually desirable to cut the branch a couple months in advance.
Send a [DISCUSS] email to dev@geode.apache.org proposing that a new support branch be created.
Confirm that the Geode LICENSE and NOTICE files on develop are accurate (ask for help on the dev list if needed). This is best done before cutting the branch, otherwise be sure to backport any changes to the support branch as well.
cd .. && ./geode/dev-tools/release/license_review.sh -v HEAD -p 1.12.0 (replace 1.12.0 with the version of the previous release) to check the LICENSE files for missing dependencies or outdated versions and compare dependencies against a previous release. If any dependencies were removed, manually check for stale references in LICENSE or NOTICE files that can be removed. If new dependencies were added that have Apache 2.0 License, add them to the license_review script's isApache2 function. If a new 3rd-party .jar is now appearing in the binary distribution, update geode-assembly/src/main/dist/LICENSE appropriately. If new 3rd-party intellectual property was checked into the source tree (e.g. a javascript library), update both LICENSE and geode-assembly/src/main/dist/LICENSE.From one directory above a checkout of latest geode develop, run the create_support_branches script. This will create branches on all projects and update version numbers appropriately, and guide you though creating the support pipeline, updating Jira, and creating a PR to bump develop to the next version.
cd .. geode/dev-tools/release/create_support_branches.sh -v 1.13 -g your_github_username |
Review the benchmark baseline on the support branch. It should usually be {previous release}
See ci/pipelines/shared/jinja.variables.yml around line 20 (under benchmarks:)
baseline_version: '1.12.0' |
Send email to dev@geode.apache.org informing the creation of the support branch and any rules for backporting changes to the branch.
Hello Geode Dev Community,
We have created a new support branch for Apache Geode {x.y.0} - "support/{x.y}"
Please focus your acceptance testing on this branch and raise any concerns in the next few weeks. If any changes are needed please add blocks-{x.y.0} label in Jira and create a PR against support/{x.y}. After some quiet period we will prepare a release candidate and begin voting upon it.
Regards
{Release Manager} |
For the duration of the release process, continue to monitor the new release pipeline and address any issues that may arise, including analyzing any test failures (ask for volunteers on the dev list to investigate any failures you are unsure of).
The create_support_branches script already walked you through creating the PR for this, adding the new version to Jira, and bumping the pipeline version on develop. (note: you must be in the Jira Administrators group to see the Add button in Jira; request permission on the dev list if you don't see it).
There are two parts to this audit:
To help automate the process of identifying commits and tickets in need of review, you may find this script useful, or create your own script.
Tips:
Also write up a short paragraph on what was added to the release. This will need to go with the final announce email. Sample:
Geode 1.13.0 contains a number of improvements and bug fixes. Changes since last release: - Performance improvements in OQL order-by and distinct queries in client/server when security is enabled. - New GFSH commands were added to get/set cluster config and to destroy gateway receivers. - A new post processor was added to the new client protocol. - Pulse now supports legacy SSL options. - Auto-reconnecting members no longer reuse old addresses and IDs. - Duplicated or member-specific receivers are removed from cluster config during rolling upgrades. Users are encouraged to upgrade to the latest release. |
It is expected that some stabilization work may be needed once the support branch is cut. This phase may be very short or very long until a Release Candidate is proposed.
The Release Manager will set the rules for backporting changes to the support branch. For example, they may stipulate critical fixes only and/or require a dev list proposal and/or require a PR against the support branch and/or require a label to be added in Jira. In all cases, fixes need to be made on develop first, then backported.
By some method, determine when all fixes are in. This might involve one or more of:
When all signs point to "go", you can either just create the RC and propose it in one email, or if there is any uncertainly, start a dev list discussion first.
From one directory above a checkout of latest geode develop, run the prepare_rc script (a release-n.n.n-workspace dir will be created in the current directory). This script will do a fresh checkout of the support branch for all repos, build them, and prepare the artifacts. It will also prepare RC tags in each repository and finally pre-stage to nexus. Do not run this in a remote shell or headless environment, as a GUI is required to prompt for your GPG passphrase (several times) and your ASF LDAP password (Apache password). Do not include @apache.org in your apache username. If your are not a PMC member or committer, when prompted for SVN password, hit enter and ask a PMC member or committer to enter their username and password, otherwise you will not be able to make the final release later.
geode/dev-tools/release/prepare_rc.sh -v 1.13.0.RC1 -k last_8_digits_of_your_gpg_key -a your_apache_ldap_username |
The "next steps" printed out at the end of the prepare_rc script will walk you through the remaining steps to finalize nexus staging (pictured below), publish the release candidate, and send the VOTE email.
If there is an older geode staging repository listed (from a previous RC, make sure you drop it. Find "orgapachegeode-####" and click on "Drop"
commit_rc, before giving the RC to the community to validate, make an rc pipeline to validate that the artifacts are viable (do this in a separate terminal window as it can be quite verbose):geode/dev-tools/release/deploy_rc_pipeline.sh -v 1.13 |
2. wait for all jobs to turn green (about 1-2 hours)
The last instruction from the prepare_rc script will be to run the commit_rc script. When that is complete, it will print out the contents of the email for you to send (and also copy it to your clipboard, if you have pbcopy installed). If you need to re-generate the email for any reason, use geode/dev-tools/release/print_rc_email.sh.
Click on every link to validate (especially release notes!), then send the email to the dev@geode.apache.org with subject "[VOTE] Apache Geode <ver>.RC<n>".
The voting deadline should be at least 72 hours in the future (typically 3pm 5 days hence if there is a weekend). For emergency patch releases, an expedited voting deadline of as little as 24 hours may be used.
After the deadline has passed, reply to the VOTE thread with a voting result summary similar to the following (use the PMC roster to determine which votes are binding):
It's past the announced deadline and we have enough votes to close the vote.
Voting status
==========
+1: 3 binding votes
* Name (PMC member)
* Name (PMC member)
* Name (PMC member)
* Other Name
* Other Name
+0: zero votes
-0: zero votes
-1: zero votes
The voting meets the requirements of at least 3 PMC members with +1 votes and has the required majority of +1 votes.
Apache Geode {ver}.RC{n} has passed the vote and we will finalize the release shortly.
Thanks everyone for the great work!
-{Release Manager} |
If not enough votes are received, the release manager may, at their discretion, extend the voting deadline, or abandon the release.
If the voting is successful, proceed to the next section. If showstopper issues were raised, create a new release candidate. If the release is to be abandoned, destroy any staged artifacts in nexus and svn.
Once a release candidate has been approved:
Fork button in top-right corner)docker info and docker images. On Linux, you may need to add sudo before each docker command in the promote_rc script and/or sudo usermod -aG docker $USERFrom the same directory you ran the previous release scripts, run the promote_rc script (note: you must be a Geode PMC member to svn commit to dist/release/geode):
geode/dev-tools/release/promote_rc.sh -v 1.13.0.RC1 -k last_8_digits_of_your_gpg_key -g your_github_username |
pbcopy installed). You can also (re)generate the email later using geode/dev-tools/release/print_announce_email.sh. It's ok to start on the steps below while you are waiting for promote_rc to finish.
... to get the Actions pop-up menu for the version you are releasing
Locate (but do not click on) the row with the final release tag (e.g. rel/v1.13.0)
Click on the 2nd "..." menu (the one to the right of the Verified bubble), then Create release.
Apache Geode 1.13.0.Describe the release:
Copy the summary sentence from the release notes.
Add the SHA256 (e.g. from the directory you ran the release scripts, cat release-1.13.0-workspace/geode/geode-assembly/build/distributions/apache-geode-1.13.0.tgz.sha256).
Add a link to the release notes. Example:
This release contains some new gfsh commands and support for SNI as well as a number of improvements and bug fixes. sha256 for apache-geode-1.13.0.tgz is 8caf6dcafa5c6bb7c10dc7d512d0569dd16e463e01c18997118e20a5f43e6097 See full release notes at https://cwiki.apache.org/confluence/display/GEODE/Release+Notes#ReleaseNotes-1.13.0 |
release-1.13.0-workspace/geode/geode-assembly/build/distributions/apache-geode-1.13.0.tgz)Ask on the dev list if you need help with these steps.
Keep only the latest patch release of each of the 3 most recent minors (including the one you're about to release) on https://geode.apache.org/releases/
(note: These steps are also covered by the "Final steps" printed at the end of promote_rc)
Confirm that your brew PR has been merged or closed and brew install apache-geode picks up the new release. Note: this may take overnight...no need to hold the release announcement just for brew.
brew uninstall apache-geode brew install apache-geode gfsh version |
Now is the best time to bump dependency versions on develop for the various 3rd-party libraries used by Geode. Start a DISCUSS thread asking for a volunteer to lead this effort.
Subject: [DISCUSS] Volunteer to update 3rd-party libraries used by GEODE
Hello Apache Geode Community,
It's time to update the 3rd-party libraries used by GEODE. We need a volunteer to take on this responsibility.
https://github.com/apache/geode/blob/develop/dev-tools/dependencies/README.md describes how to carry out this task.
It would be awesome to get this done within the next few weeks, to allow plenty of time to shake out any issues before the next release.
Regards,
{Release Manager} on behalf of the Apache Geode team |
Geode's N-2 support policy allows patch releases to be proposed for its 3 most recent minors, e.g. on the day 1.15.0 is released, 1.12 would become no longer supported. But this is not set in stone, so it's probably wise to start a discussion on the dev list before just running this command!
geode/dev-tools/release/end_of_support.sh -v 1.{N-3} |
Note tha end_of_support is a destructive command. It will prompt you to continue, then will delete the branch and pipeline. If run by accident, these can be restored by re-flying the pipeline and re-pushing the branch (if you or someone has an up-to-date local copy, otherwise google git reflog for more ways to recover a deleted branch).
The template for this email was output at the end of promote_rc, or you can re-generate it using geode/dev-tools/release/print_announce_email.sh. Consider customizing the generated text if there are more upcoming releases (or even waiting and combining the announcements) or if there are notable fixes worth highlighting after the generic "contains a number of fixes".
*** Important: Send the email from your apache email ID*** (otherwise announce@apache.org will bounce. See https://infra.apache.org/committer-email.html for how to send email from your apache email address)
*** Important: Send the email as plain text***(otherwise announce@apache.org will reject the email. If using gmail, at the bottom of the compose window, click the three-dot menu then click Plain text mode)
Example:
To: user@geode.apache.org, announce@apache.org, dev@geode.apache.org
Subject: [ANNOUNCE] Apache Geode {version e.g. 1.13.0}
The Apache Geode community is pleased to announce the availability of
Apache Geode {version e.g. 1.13.0}.
Apache Geode is a data management platform that provides a database-like
consistency model, reliable transaction processing and a shared-nothing
architecture to maintain very low latency performance with high concurrency
processing.
Geode {version e.g. 1.13.0} contains a number of improvements and bug fixes. It includes performance improvements in OQL order-by and distinct queries in client/server when security is enabled. New GFSH commands were added to get/set cluster config and to destroy gateway receivers. A new post processor was added to the new client protocol. Pulse now supports legacy SSL options. Auto-reconnecting members no more reuse old addresses and IDs. Duplicated or member-specific receivers are removed from cluster config during rolling upgrades. Users are encouraged to upgrade to the latest release.
For the full list of changes please review the release notes:
https://cwiki.apache.org/confluence/display/GEODE/Release+Notes#ReleaseNotes-{version e.g. 1.13.0}
The release artifacts can be downloaded from the project website:
https://geode.apache.org/releases/
The release documentation is available at:
https://geode.apache.org/docs/guide/{version eg. 113}/about_geode.html
We would like to thank all the contributors that made the release possible.
Regards,
{Release Manager} on behalf of the Apache Geode team |