Release#

Unstable versions / Staging environment#

Potentially unstable versions should be deployed to the staging environment (dev.gewaessercampus.de) first. Make sure to tag them accordingly (alpha, beta, rc) and set the checkbox for pre-release in the GitHub UI.

Pre-Release-Checks#

Make sure to check the following list before releasing a new major or minor version. You can use the fixture to import a dataset covering different combinations of courses, access keys, parameters, measurements, etc. into your local environment.

  • Check that the testsuite is passing.

  • Check that translations are up-to-date.

  • Check that all of the following actions work as intended.

    • Use the map to explore all measurements.

    • Register a new course.

    • Login & Logout with a course token.

    • Login & Logout with an access key.

    • Manage the access keys of a course through the course administration page.

    • Create a new measurement.

    • Edit an existing measurement.

    • Use a calibration to convert Optical Density to concentration.

    • Filter the list of measurements.

    • Filter the list of waters.

    • Download a measurement detail document.

    • Download a measurement list document.

    • Download a csv summary from the list of measurements.

Creating a new release#

Then follow these steps to create a new release:

  • Update version in gcampus/__init__.py

  • Create git tag with version.

  • Commit and push to remote (including the tag).

  • Use the GitHub UI to create a release.

  • Wait for the Actions to complete, then check that deployment was successful.