The following instructions describe how to create a new BioSimSpace release:
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.
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 BioSimSpace."Push the commit and tag to the devel branch on the remote:
git push origin devel --follow-tagsThis 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.0Next, delete the Conda release package from the Anaconda Cloud. You can then move the tag to the latest commit:
git tag -fa 2019.1.0Finally, push the new commit and updated tag:
git push origin devel --follow-tagsOnce 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 add download links to the
install
page in the website documentation and move the download links for the previous
release to the binaries
page. (Note that the website won't be updated until you next trigger a
development build. Alternatively, you can move the tag to this commit and
re-push following the instructions above. The binaries will be overwritten,
but the URLs won't change.)
Create a GitHub release. When drafting the release, simply choose the tag that you have created.
Create a pull request to
merge devel into the master branch.
That's it!