dev:release_process:evergreen:how_to_build
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| dev:release_process:evergreen:how_to_build [2024/05/13 15:06] – [Other version number changes] aneiman | dev:release_process:evergreen:how_to_build [2024/06/06 15:21] (current) – [Prerequisites] aneiman | ||
|---|---|---|---|
| Line 14: | Line 14: | ||
| Make sure you are in an environment with your git ssh keys, since you will need to be pushing commits to the git server. | Make sure you are in an environment with your git ssh keys, since you will need to be pushing commits to the git server. | ||
| + | |||
| + | To upload translations to Launchpad, you will also need to register an ssh key with Launchpad. See the [[https:// | ||
| See [[:: | See [[:: | ||
| Line 60: | Line 62: | ||
| $ find . -mindepth 2 -name ' | $ find . -mindepth 2 -name ' | ||
| $ find . -mindepth 2 -name ' | $ find . -mindepth 2 -name ' | ||
| + | $ echo "" | ||
| </ | </ | ||
| Line 165: | Line 168: | ||
| * Replace release version placeholders (X.X.X) with the actual version numbers in docs/ | * Replace release version placeholders (X.X.X) with the actual version numbers in docs/ | ||
| - | * * In vim, '': | + | |
| - | * If you are creating a beta or rc, add a hyphen and then beta or rc. For example, 3.12-rc. | + | * If you are creating a beta or rc, add a hyphen and then beta or rc. For example, 3.13-rc. |
| * Replace the previous version placeholder (e.g. 3.X.W) with the last release number. | * Replace the previous version placeholder (e.g. 3.X.W) with the last release number. | ||
| - | * * In vim, '': | + | |
| * Double check the correct minimum version of OpenSRF. | * Double check the correct minimum version of OpenSRF. | ||
| * If the minimum version of OpenSRF has changed, also update the OpenSRF version number in docs/ | * If the minimum version of OpenSRF has changed, also update the OpenSRF version number in docs/ | ||
| Line 174: | Line 177: | ||
| ==== Run the release builder script ==== | ==== Run the release builder script ==== | ||
| - | * Run the release builder script | + | Run the release builder script: |
| <code bash> | <code bash> | ||
| $ export PATH=$PATH:/ | $ export PATH=$PATH:/ | ||
| - | $ build/ | + | $ build/ |
| </ | </ | ||
| - | * Additional notes on make_release options: | + | Additional notes on make_release options: |
| - | * Use the -v flag when your branch name does not match the normal pattern, otherwise auto-detect works | + | * If you are building beta, use -beta for the first version value, for example: 3.13-beta. |
| - | * Use the -j flag to point at wherever your OpenSRF javascript lib source is, if not already installed | + | * Use the highest numbered previous version for the second version value. |
| - | * -j ~/ | + | |
| - | * The -f flag sets the branch " | + | * For a .0 release, the script should start from the highest point release in the previous series: <code bash>$ build/ |
| - | * You can add the -r option to edit the upgrade script before it goes into the tarball. This may be necessary if tables that get altered in the upgrade scripts also have updates or inserts of new data. | + | * For a point release, the script should start from the previous point release in the series: <code bash>$ build/ |
| - | * Enhanced Concerto Dataset upgrade *experimental | + | |
| - | * This is optional, but if enough of the database tables have changed, it's a good idea. | + | * Use the -j flag to point at wherever your OpenSRF javascript lib source is, if not already installed |
| - | * -H < | + | * -j ~/ |
| - | * -U < | + | * The -f flag sets the branch " |
| - | * -P < | + | * You can add the -r option to edit the upgrade script before it goes into the tarball. This may be necessary if tables that get altered in the upgrade scripts also have updates or inserts of new data. |
| - | * -O < | + | * Enhanced Concerto Dataset upgrade *experimental |
| - | * Omitting -H will cause make_release to skip the enhanced concerto upgrade steps. | + | * This is optional, but if enough of the database tables have changed, it's a good idea. |
| + | * -H < | ||
| + | * -U < | ||
| + | * -P < | ||
| + | * -O < | ||
| + | * Omitting -H will cause make_release to skip the enhanced concerto upgrade steps. | ||
| Note that you will get a lot of warnings related to the po translation files. | Note that you will get a lot of warnings related to the po translation files. | ||
| Line 224: | Line 232: | ||
| * Release notes go in ''/ | * Release notes go in ''/ | ||
| + | Because the release notes document is cumulative for each release series, a symbolic link exists for each release series so that (e.g.) '' | ||
| + | |||
| + | When updating the downloads page to the website, the URL should use the symbolic link, not the release notes for the specific release, e.g., '' | ||
| ==== " | ==== " | ||
| <code bash> | <code bash> | ||
| - | git push origin tags/rel_3_12_1:tags/rel_3_12_1 | + | git push origin tags/rel_3_13_0:tags/rel_3_13_0 |
| </ | </ | ||
dev/release_process/evergreen/how_to_build.1715627167.txt.gz · Last modified: 2024/05/13 15:06 by aneiman