Skip to content

Commit

Permalink
Merge #1062: docs: update release process
Browse files Browse the repository at this point in the history
c9f4dfd docs: update release process (Jose Celano)

Pull request description:

  I've updated the release process. The process is the same, so I didn't bump the version. I just added a new check because I didn't realise in the recent releases that the deployment workflow failed.

  I've also fixed markdown linter errors.

ACKs for top commit:
  josecelano:
    ACK c9f4dfd

Tree-SHA512: b3fedb1863bf7d0945987bd0bba8430b925518a4a73f551b69620b02dff5d65792d073c63a3c4e496863047b3fba949b2fdcee23555923b35922df97642dbcd7
  • Loading branch information
josecelano committed Oct 7, 2024
2 parents ab9f6e0 + c9f4dfd commit cb9e345
Showing 1 changed file with 28 additions and 13 deletions.
41 changes: 28 additions & 13 deletions docs/release_process.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
# Torrust Tracker Release Process (v2.2.2)
# Torrust Tracker Release Process (v2.2.2)

## Version

## Version:
> **The `[semantic version]` is bumped according to releases, new features, and breaking changes.**
>
> *The `develop` branch uses the (semantic version) suffix `-develop`.*
## Process:
## Process

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

Expand All @@ -20,18 +21,18 @@ git remote show torrust
...
```

### 1. The `develop` branch is ready for a release

### 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:
### 2. Stage `develop` HEAD for merging into the `main` branch

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

### 3. Create Release Commit:
### 3. Create Release Commit

```sh
git stash
Expand All @@ -43,13 +44,13 @@ git commit -m "release: version [semantic version]"
git push torrust
```

### 4. Create and Merge Pull Request from `staging/main` into `main` branch.
### 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:
### 5. Push new version from `main` HEAD to `releases/v[semantic version]` branch

```sh
git fetch --all
Expand All @@ -58,25 +59,39 @@ git push torrust main:releases/v[semantic version]

> **Check that the deployment is successful!**
### 6. Create Release Tag:
### 6. Create Release Tag

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

### 7. Create Release on Github from Tag.
Make sure the [deployment](https://github.com/torrust/torrust-tracker/actions/workflows/deployment.yaml) workflow was successfully executed and the new version for the following crates were published:

- [torrust-tracker-contrib-bencode](https://crates.io/crates/torrust-tracker-contrib-bencode)
- [torrust-tracker-located-error](https://crates.io/crates/torrust-tracker-located-error)
- [torrust-tracker-primitives](https://crates.io/crates/torrust-tracker-primitives)
- [torrust-tracker-clock](https://crates.io/crates/torrust-tracker-clock)
- [torrust-tracker-configuration](https://crates.io/crates/torrust-tracker-configuration)
- [torrust-tracker-torrent-repository](https://crates.io/crates/torrust-tracker-torrent-repository)
- [torrust-tracker-test-helpers](https://crates.io/crates/torrust-tracker-test-helpers)
- [torrust-tracker](https://crates.io/crates/torrust-tracker)

### 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:
### 8. Stage `main` HEAD for merging into the `develop` branch

Merge release back into the develop branch.

```sh
git fetch --all
git push --force torrust main:staging/develop
```
### 9. Create Comment that bumps next development version:

### 9. Create Comment that bumps next development version

```sh
git stash
Expand All @@ -88,7 +103,7 @@ 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.
### 10. Create and Merge Pull Request from `staging/develop` into `develop` branch

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

Expand Down

0 comments on commit cb9e345

Please sign in to comment.