mantisbt:release_process
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| mantisbt:release_process [2021/03/07 18:14] – [Packaging the Release] dregad | mantisbt:release_process [2025/12/29 21:02] (current) – [Notifications] link to blog, forums dregad | ||
|---|---|---|---|
| Line 45: | Line 45: | ||
| ==== Localization ==== | ==== Localization ==== | ||
| + | |||
| + | <WRAP tip right 50%> | ||
| + | Translation updates are regularly committed to the //master// branch by an automated process. | ||
| + | Contact the [[https:// | ||
| + | </ | ||
| * Post on the [[mantisbt-lang@lists.sourceforge.net|Localization mailing list]] to request translation updates from contributors | * Post on the [[mantisbt-lang@lists.sourceforge.net|Localization mailing list]] to request translation updates from contributors | ||
| - | * Run / | + | * Run /// |
| Line 66: | Line 71: | ||
| ===== Preparing the Release ===== | ===== Preparing the Release ===== | ||
| - | ==== Localization | + | ==== Define VERSION environment variable |
| - | * Contact the [[http:// | + | This will be used by several commands later in this section. |
| + | |||
| + | < | ||
| + | $ VERSION=M.N.P | ||
| + | </ | ||
| ==== Repository Preparation ==== | ==== Repository Preparation ==== | ||
| * Remove references to any debug statements | * Remove references to any debug statements | ||
| - | * Update CREDITS file. | + | * Update |
| - | | + | * Run the script to update the Contributors' list < |
| - | * Run the script to update the Contributor's list < | + | |
| $ update-credits.sh | $ update-credits.sh | ||
| + | </ | ||
| + | The script will detect if the // | ||
| + | |||
| + | It will print a list of duplicates and halt to let you manually update the file; refer to [[mantisbt: | ||
| + | </ | ||
| + | * Run the script again after fixing the // | ||
| + | * If needed, make any additional changes to the CREDITS file manually | ||
| + | * Update the **version number** | ||
| + | * in // | ||
| + | sed -r -i "/ | ||
| + | </ | ||
| + | * in REST API OpenAPI documentation < | ||
| + | sed -r -i "/ | ||
| </ | </ | ||
| - | * If needed, make any additional changes manually | ||
| - | * Update the version number in core/ | ||
| * Commit the changes. | * Commit the changes. | ||
| - | |||
| ===== Cutting the Release ===== | ===== Cutting the Release ===== | ||
| - | * Create an annotated, GPG-signed tag in Git; the tag should be formatted as "release-1.x.x" | + | * Create an annotated, GPG-signed tag in Git; the tag should be formatted as '' |
| * For **stable releases** < | * For **stable releases** < | ||
| - | $ git checkout master-1.M.x | + | $ git checkout master-M.N |
| - | $ VERSION=1.M.N | + | |
| $ git tag -s release-$VERSION -m " | $ git tag -s release-$VERSION -m " | ||
| </ | </ | ||
| * For **development releases** (e.g. alpha, beta, release candidates) < | * For **development releases** (e.g. alpha, beta, release candidates) < | ||
| $ git checkout master | $ git checkout master | ||
| - | $ VERSION=1.M.N | + | $ VERSION=M.N.P |
| $ git tag -s release-$VERSION -m " | $ git tag -s release-$VERSION -m " | ||
| </ | </ | ||
| Line 102: | Line 119: | ||
| </ | </ | ||
| - | * In case we are starting a new stable branch, also create it using the format " | + | * In case we are starting a new stable branch, also create it using the format " |
| - | $ git branch master-1.x.x master | + | $ git branch master-M.N master |
| - | $ git push origin master-1.x.x | + | $ git push origin master-M.N |
| </ | </ | ||
| Line 135: | Line 152: | ||
| Generate release tarballs using the '' | Generate release tarballs using the '' | ||
| < | < | ||
| - | $ / | + | $ / |
| </ | </ | ||
| - | This will create | + | This will create the following files in the ''/ |
| - | [dregad] | + | * a //.zip// and //.tar.gz// tarball of the release |
| + | * a //.digest// file for each tarball with //md5// and, //sha*// hashes | ||
| + | * an ASCII-armored GPG signature file for each tarball (with //.asc// extension) | ||
| + | |||
| + | The '' | ||
| Line 246: | Line 267: | ||
| ==== Source Forge ==== | ==== Source Forge ==== | ||
| - | * Upload the release to [[http:// | + | * Upload the release to [[http:// |
| - | * Release | + | Put the files in the appropriate directory, based on the release type: Stable releases go to the **mantis-stable**; |
| - | | + | |
| - | * Put the release in the appropriate package based on whether it is a stable | + | Create a sub-directory for the version, matching it's number |
| - | * Release candidates, alphas and betas are " | + | </ |
| + | * manually via SourceForge' | ||
| + | * with rsync (// | ||
| + | $ rsync -vP --rsh=ssh / | ||
| + | </ | ||
| * Download the release off SF.net and verify correctness. | * Download the release off SF.net and verify correctness. | ||
| - | * Click the "i" | + | * Click the '' |
| * for digests, exclude them from stats. | * for digests, exclude them from stats. | ||
| * In case of a stable release, make the zip file the default for all platforms. | * In case of a stable release, make the zip file the default for all platforms. | ||
| Line 258: | Line 283: | ||
| ==== Notifications ==== | ==== Notifications ==== | ||
| - | * Blog: Post an announcement | + | * [[https:// |
| + | * [[https:// | ||
| + | * [[https:// | ||
| + | * [[https:// | ||
| + | |||
| + | The notifications below require accounts that only vboctor has access to... | ||
| * Twitter: announce the release via mantisbt twitter account. | * Twitter: announce the release via mantisbt twitter account. | ||
| * Update mailing list based on official bug tracker users since users can now signup to our bugtracker to get such announcements. | * Update mailing list based on official bug tracker users since users can now signup to our bugtracker to get such announcements. | ||
mantisbt/release_process.1615158850.txt.gz · Last modified: by dregad