Skip to content

Latest commit

 

History

History
89 lines (60 loc) · 2.84 KB

RELEASE_INSTRUCTIONS.rst

File metadata and controls

89 lines (60 loc) · 2.84 KB
Raw

Sire release instructions

The following instructions describe how to create a new Sire release:

Step 1

Update the version number in the CMakeLists.txt files here and here.

Step 2

Update the CHANGELOG file with a summary of the changes for this relase. Feel free to link to GitHub issues where relevant and give credit for specific contributions.

Step 3

When you're happy, tag the commit that you want to be associated with the release. The following will tag the latest commit:

git tag -a 2019.1.0 -m "Tagging the 2019.1.0 release of Sire."

Step 4

Push the commit and tag to the devel branch on the remote:

git push origin devel --follow-tags

This will trigger a new Azure Pipelines build which will create binaries and Conda packages for the release. If you make a mistake and want to move the tag to a later commit, simply delete the tag from the remote:

git push origin :refs/tags/2019.1.0

Next, delete the Conda release package from the Anaconda Cloud. You can then move the tag to the latest commit:

git tag -fa 2019.1.0

Finally, push the new commit and updated tag:

git push origin devel --follow-tags

Step 5

Once the build has finished you can log into the Oracle Cloud and create pre-authenticated URLs for the new release binaries. (These files are currently located in the software_releases compartment of the Object Storage menu.) When generating a download URL make sure to choose a sensible expiry date. Copy the URL to your clipboard and then paste it into a new file called redirect_sire_YYYY_MAJOR_MINOR_OS.run in the largefiles/sire_releases directory of the siremol.org GitHub repository. Following this you'll also need to update the pages/binaries.md file with download links for the new release. Make sure to add a MD5 hashes for the files and to move the download links for the previous release to the Older Versions section at the bottom of the page.

Step 6

Create a GitHub release. When drafting the release, simply choose the tag that you have created.

Step 7

Create a pull request to merge devel into the master branch.

That's it!