Create A Release

How to create a release

1. Update issues and pull requests so they are appropriately targeted for this milestone and closed

2. Ensure all changes are described in the CHANGES.md file

3. Test the pending changes on a staging system

4. Tag the release using semantic versioning

   cd <geni-portal>
   git checkout master
   git tag -a v3.X -m "Release 3.X" master
   git push upstream --tags

5. Update GitHub milestones

   • Close the current milestone
   • Create a new milestone for the next release

6. Create distribution tar files and build RPMs

   • Create a distribution tar file using make dist
   • Create both RPM and SRPM packages following instructions in README-packaging.md

7. Create a GitHub release, upload the tar file and RPMs

   • Create a release (Releases; Draft a new release)
   • Use the current tag
   • Name it "Major.Minor[.Patch]"
   • Paste in the headings bullets from CHANGES.md for this release
   • Upload the tar file (from make dist), the RPMs, and the documentation (from make pdf)

8. Bump the version numbers on the develop branches

   • Note: Use the standard contribution process by submitting these changes via a pull request on your fork, not a direct push to the GENI-NSF repository
   • Add a new version line to CHANGES.md
   • Bump version number in configure.ac
   • Bump version number in the RPM spec file (geni-xyz.spec)
   • Update INSTALL-centos.md to reflect new RPM URL