Skip to content

Latest commit

 

History

History
99 lines (69 loc) · 2.4 KB

release_process_guide.md

File metadata and controls

99 lines (69 loc) · 2.4 KB

Release Process Guide (v2.2.2)

Version

The [semantic version] is bumped according to releases, new features, and breaking changes.

The develop branch uses the (semantic version) suffix -develop.

Process

Note: this guide assumes that the your git torrust remote is like this:

git remote show torrust
* remote torrust
  Fetch URL: [email protected]:torrust/torrust-index-gui.git
  Push  URL: [email protected]:torrust/torrust-index-gui.git
...

1. The develop branch is ready for a release

The develop branch should have the version [semantic version]-develop that is ready to be released.

2. Stage develop HEAD for merging into the main branch

git fetch --all
git push --force torrust develop:staging/main

3. Create Release Commit

git stash
git switch staging/main
git reset --hard torrust/staging/main
# change `[semantic version]-develop` to `[semantic version]`.
git add -A
git commit -m "release: version [semantic version]"
git push torrust

4. Create and Merge Pull Request from staging/main into main branch

Pull request title format: "Release Version [semantic version]".

This pull request merges the new version into the main branch.

5. Push new version from main HEAD to releases/v[semantic version] branch

git fetch --all
git push torrust main:releases/v[semantic version]

Check that the deployment is successful!

6. Create Release Tag

git switch releases/v[semantic version]
git tag --sign v[semantic version]
git push --tags torrust

7. Create Release on Github from Tag

This is for those who wish to download the source code.

8. Stage main HEAD for merging into the develop branch

Merge release back into the develop branch.

git fetch --all
git push --force torrust main:staging/develop

9. Create Comment that bumps next development version

git stash
git switch staging/develop
git reset --hard torrust/staging/develop
# change `[semantic version]` to `(next)[semantic version]-develop`.
git add -A
git commit -m "develop: bump to version (next)[semantic version]-develop"
git push torrust

10. Create and Merge Pull Request from staging/develop into develop branch.

Pull request title format: "Version [semantic version] was Released".

This pull request merges the new release into the develop branch and bumps the version number.