...
- If you are using GPG Tools >= 2.1, export your secret key to a file to be used by Gradle. You can export it with `gpg --export-secret-keys >~/.gnupg/secring.gpg`
From a checkout of geode, run the prepare_rc.sh script
Code Block cd dev-tools/release ./prepare_rc.sh -v version_with_rc -k your_8_digit_key_id
This script assumes there is a release/X.Y.Z branch pushed to all of the geode repositories (geode, geode-native, geode-examples). It will checkout the tip of that branch for all repos, build them, and copy the artifacts to the build/dist directory. It will also tag the RC in each checkout.
- Review the artifacts and revisions under build before moving in to publishing. You should see these directories
- geode
- geode-examples
- geode-native
- dist
- Log in to repository.apache.org and select staging repositories. Find "orgapachegeode-####" and clink on "Drop"
Clean and build Publish the artifacts to the nexus staging repositories. Run this command on a machine using GUI as you will be prompted to enter PGP and ASF LDAP password (Apache password). You will see messages like "Could not find metadata org.apache.geode:geode-cq/maven-metadata.xml" on your terminal. Ignore them.
Code Block language bash git clean -fdx && cd build/geode ./gradlew clean build publish -Paskpass -Psigning.keyId=last_8_characters_of_your_gpg_fingerprint -Psigning.secretKeyRingFile=/Users/yourusername/.gnupg/secring.gpg mavenUsername-PmavenUsername=your_apache_ldap_username
Publish release artifacts to ASF dist repo. DO NOT DELETE THE FOLDERS CREATED IN THIS STEP - THEY ARE NEEDED FOR THE FINAL RELEASE.
Code Block language bash #create a new empty directory svn checkout https://dist.apache.org/repos/dist --depth empty svn update --set-depth infinity --parents dist/dev/geode svn update --set-depth infinity --parents dist/release/geode cd dist/dev/geode # copy the KEYS file from the apache-geode release branch folder in your system. cp ${GEODE_SRC}/KEYS . svn commit -m "Updating Apache Geode KEYS file" mkdir {version}.RC# cp ${GEODE_SRC}/geode-assembly/build/distributions/* {version}.RC# svn add {version}.RC# svn commit -m "Releasing Apache Geode {version}.RC# distribution"
- Verify that all the artifacts have been uploaded to the nexus repository by logging into repository.apache.org and then click on close. Example:
In the release branch folder tag the commit. All Release Candidates start with the number 1 eg. RC1. Be careful as `rel/` folder is protected, once we push the release tag to server, it cannot be modified. Any other change will have to be moved to the next RC number.
Code Block language bash git config user.email "email_address_associated_with_your_gpg_key" git tag -s rel/v{version}.RC# -m "Release candidate # for 1.0.0" git push origin rel/v{version}.RC#
Now checkout the repo for geode-examples and create a release branch.
Code Block title Create release branch git checkout develop git checkout -b release/{version}
Update the version number in gradle.properties of geode-examples
Code Block version = 1.7.0 geodeVersion = 1.7.0
- Commit the version changes and push the release branch of geode-examples
Code Block git add -p git commit git push origin HEAD
check that gfsh is not on your path already
Code Block $ gfsh -bash: gfsh: command not found
In the geode-examples folder, build and run it with the apache-geode version that was uploaded to the ASF dist repo.
Code Block # first build the release artifacts, specifying the RC release location and staging repository git clean -dxf && ./gradlew -PsignArchives -PgeodeReleaseUrl=https://dist.apache.org/repos/dist/dev/geode/{version}.RC# -PgeodeRepositoryUrl=https://repository.apache.org/content/repositories/orgapachegeode-{NNNN} build runAll #if all tests pass then continue ahead, else kindly fix the issues
If there are no failures, then tag the release candidate in geode-examples.
Code Block # then tag the release candidate commit cd ${GEODE_EXAMPLES_SRC} git config user.email "email_address_associated_with_your_gpg_key" git tag -s rel/v{version}.RC# -m "Release candidate # for 1.0.0" git push origin rel/v{version}.RC#
Info If you are running on linux, you may see this error message:
error: gpg failed to sign the data
error: unable to sign the tag
If you get that error message, try to sign some random file so that gpg will unlock your keyring. After that the git tag -s should work.
Publish the examples artifacts to ASF dist repo using the folder created in step 5
Code Block # then upload the release artifacts for distribution # go to the folder created in step 6 and copy the geode-example artifacts to it cd dist/dev/geode cp ${GEODE_EXAMPLES_SRC}/build/distributions/* {version}.RC# svn add {version}.RC#/apache-geode-examples-* svn commit -m "Adding examples to Apache Geode {version}.RC# distribution"
Make sure you have the native client required components installed. On a Mac
Code Block brew install cmake brew install doxygen
Checkout geode-native from https://github.com/apache/geode-native. Then `cd` into the geode-native directory, create a build directory, configure cmake and generate the source distribution via cpack
Code Block language bash mkdir build cd build cmake .. -DPRODUCT_VERSION={version} -DOPENSSL_ROOT_DIR=/usr/local/Cellar/openssl/1.0.2* -DGEODE_HOME=your_geode_checkout/geode-assembly/build/install/apache-geode cpack -G TGZ --config CPackSourceConfig.cmake
This should have generated a tar file and a corresponding checksum file. Let's sign the package:
Code Block language bash gpg --armor -u {key ID} -b apache-geode-native-*-src.tar.gz
Verify that the command created a new file called `apache-geode-native-{version}-Source.tar.gz.asc`.
Tag the release candidate in geode native:
Code Block # then tag the release candidate commit cd ${GEODE_NATIVE_SRC} git tag -s rel/v{version}.RC# -m "Release candidate # for 1.0.0" git push origin rel/v{version}.RC#
Publish the geode native artifacts to ASF dist repo using the folder created in step 5
Code Block language bash cd dist/dev/geode cp ${GEODE_NATIVE_SRC}/build/apache-geode-native-{version}* {version}.RC# svn add {version}.RC#/apache-geode-native-* svn commit -m "Adding Geode Native source distribution to Apache Geode {version}.RC#"
...