Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Checkout the release branch.
  2. Clean the directory

    Code Block
    languagebash
    git clean -fdx


  3. Edit ~/.gradle/gradle.properties with your PGP key and ASF LDAP information:

    Code Block
    languagebash
    signing.keyId=01234567                          # Your GPG key ID, as 8 hex digits
    signing.secretKeyRingFile=/path/to/secring.gpg  # Normally in $HOME/.gnupg/secring.gpg
    mavenUsername=yourname                          # Your username on Apache's LDAP

    Note: If you are using GPG Tools >= 2.1 you likely won't have a secring.gpg file. You can export it with `gpg --export-secret-keys >~/.gnupg/secring.gpg`
              DO NOT copy the comments in the example above. Those won't be treated as comments.

  4. Log in to repository.apache.org and select staging repositories. Find "orgapachegeode-####" and clink on "Drop"
  5. Clean and build the artifacts. 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
    languagebash
    ./gradlew clean build publish -Paskpass
    
    
    #Sometime there may be an issue with gradle not picking up the credentials put in ~/.gradle/gradle.properties.
    # work around is to create a new directory somewhere eg. ~/gradle_home then create a new file in it called gradle.properties 
    # Then run the command as ./gradlew --gradle-user-home=~/gradle_home clean build uploadArchives -Paskpass


  6. Sign the source release.

    Code Block
    languagebash
    cd ${GEODE_SRC}/geode-assembly/build/distributions/*
    gpg --armor -u {KEY ID} -b apache-geode-{version}-src.tgz


  7. Copy and release artifacts to ASF dist repo. DO NOT DELETE THE FOLDERS CREATED IN THIS STEP - THEY ARE NEEDED FOR THE FINAL RELEASE.

    Code Block
    languagebash
    #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"


  8. Verify that all the artifacts have been uploaded to the nexus repository by logging into repository.apache.org and then click on close. Example:
  9. 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
    languagebash
    git tag -s rel/v{version}.RC# -m "Release candidate # for 1.0.0"
    git push origin rel/v{version}.RC#


  10. Now checkout the repo for geode-examples and create a release branch.

    Code Block
    titleCreate release branch
    git checkout -b release/{version}


  11. Update the version number in gradle.properties of geode-examples

    Code Block
    version = 1.7.0
    geodeVersion = 1.7.0


  12. 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
    ./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


  13. If there are no failures, then upload the artifacts to ASF dist repo using the folder created in step 6

    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"


  14. Tag the release candidate in geode-examples.

    Code Block
    # then tag the release candidate commit
    cd ${GEODE_EXAMPLES_SRC}
    git tag -s rel/v{version}.RC# -m "Release candidate # for 1.0.0"
    git push origin rel/v{version}.RC#



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


  16. Checkout geode-native from https://github.com/apache/geode-native. Then `cd` into the geode-native directory and , create a build directory, configure cmake and generate the source distribution via cpack

    Code Block
    languagebash
    mkdir build
    cd build
    cmake .. -DPRODUCT_VERSION={version}
    cpack -G TGZ --config CPackSourceConfig.cmake


  17. This should have generated a tar file and a corresponding checksum file. Let's sign the package:

    Code Block
    languagebash
    gpg --armor -u {key ID} -b apache-geode-native-{version}-Source.tar.gz

    Verify that the command created a new file called `apache-geode-native-{version}-Source.tar.gz.asc`.

...