Skip to content

Latest commit

 

History

History
56 lines (35 loc) · 2.21 KB

release-process.md

File metadata and controls

56 lines (35 loc) · 2.21 KB

The Aquarius Release Process

Please note that this upgrade does not affect the deployed versions of Aquarius, i.e. http://aquarius.oceanprotocol.com. Contact the Ocean Protocol team for such a deployment.

Step 0: Update documentation

This doesn't actually affect the following steps of the release. And if you've just updated READMEs, you can stop after this step if you like.

Step 1: Bump version and push changes

  • Create a new local feature branch, e.g. git checkout -b feature/bumpversion-to-v3.2.5

  • Use the bumpversion.sh script to bump the project version. You can execute the script using {major|minor|patch} as first argument to bump the version accordingly:

    • To bump the patch version: ./bumpversion.sh patch
    • To bump the minor version: ./bumpversion.sh minor
    • To bump the major version (for API-breaking changes): ./bumpversion.sh major

Version numbering

⚠️ Aquarius is still in v3. We now use a marketing version numbering convention, where non-breaking changes should be patches, and breaking changes warrant minor releases. Once we integrate the v4 contracts in the OCEAN ecosystem, Aquarius will be fully SEMVER compatible.

  • Commit the changes to the feature branch.

    git commit -m "Bump version <old_version> -> <new_version>"

  • Push the feature branch to GitHub.

    git push origin feature/bumpversion-to-v3.2.5"

Step 2: Merge changes to main branch

  • Make a pull request from the just-pushed branch.

  • Wait for all the tests to pass!

  • Merge the pull request into the main branch.

Step 3: Release

  • To make a GitHub release (which creates a Git tag):
  • Go to the Aquarius repo's Releases page https://github.com/oceanprotocol/aquarius/releases
  • Click "Draft a new release".
  • For tag version, put something like v3.2.5
  • For release title, put the same value (like v3.2.5).
  • For the target, select the main branch, or the just-merged commit.
  • Describe the main changes.
  • Click "Publish release".