Release Procedure

1. Make sure source is up to date

• % git pull

2. Do a clean test

• % ant clean test

3. Make sure there are no pending changes (if so, commit and push them)

• % git status

4. Take one of two paths, depending on whether this is a new minor version or not

• If this is a new minor version, then create a branch for it (typically from master)
• % git checkout master
• % git checkout -b version-2.5
• If this is a bug fix release, then switch to the minor version branch and merge in all changes from master
• % git checkout version-2.5
• % git merge master

5. Edit version numbers to fully specify version of release (e.g., 2.5.0 or 2.5.1, without any SNAPSHOT)

• % bbedit pom.xml
• % bbedit build.properties

6. Build the release

• % ant clean install

7. Commit your changes to your local git repository and the remote git repository

• % git commit -am "Releasing version 2.5.1"
• % git push -u origin version-2.5 # (parameter only necessary for new minor version, but won't hurt)

8. Push the jar to conjars

• % scp -i ~/.ssh/id_rsa-conjars pom.xml build/cascading.solr-2.5.1.jar [email protected]:

9. Test the uploaded jar [optional]

• % rm -rf ~/.m2/repository/com/scaleunlimited/cascading.solr/2.5.1
• modify a project that uses cascading.solr to use version 2.5.1
• build and verify the project

10. Tag the release

• % git tag -am "Tagging version 2.5.1" 2.5.1
• % git push --tags

11. Fix up version numbers.

• If you created a new minor version (e.g., 2.5)
• Bump the minor version to the next one (e.g., 2.6-SNAPSHOT) in master
• % git checkout master
• % bbedit pom.xml
• % bbedit build.properties
• Push the new minor version number
• % git commit -am "Bumping minor version number after creating branch for previous one"
• % git push
• Unless you released your new version (e.g., 2.5.1) directly from master
• Revert the version in your branch (e.g., back to 2.5-SNAPSHOT)
• % git checkout version-2.5
• % bbedit pom.xml
• % bbedit build.properties
• Push the restored minor version snapshot
• % git commit -am "Reverting to SNAPSHOT version number after releasing from branch"
• % git push

12. Send out email to Cascading list, internal users