Public Release Procedure for Projects: Difference between revisions
Jump to navigation
Jump to search
| (14 intermediate revisions by the same user not shown) | |||
| Line 4: | Line 4: | ||
=Procedure= | =Procedure= | ||
<font color=red>TODO: review all this in the light of the new release procedure [[nort Concepts#The_Release_Sequence]]. | |||
==Run <tt>release</tt> Locally== | ==Run <tt>release</tt> Locally== | ||
The procedure will increment the version string appropriately | The procedure will: | ||
* increment the version string appropriately | |||
* run tests to make sure that increase in version number does not break functionality | |||
* commit changes | |||
* optionally tag using a tag name convention that uses the release name (snapshot releases are not tagged). | |||
* push | |||
* build the installable release artifact, if the project renders itself to that. This will be referred to as "the binary", and it shall be used as "release binary" at the next step. | |||
At the end of the procedure, the Git tag used to tag the release will be displayed, so it can be used at the next step. | |||
===Procedure=== | |||
<pre> | <pre> | ||
release info | release info | ||
current version: 1.0.3-SNAPSHOT-4 | |||
release patch | |||
releasing 1.0.3, is this OK? [y/n] y | |||
... | |||
[INFO] BUILD SUCCESS | |||
... | |||
git add ok | git add ok | ||
... | |||
git commit ok | git commit ok | ||
git tag ok, tagged with release- | git tag ok, tagged with release-1.0.3 | ||
... | |||
git push ok | git push ok | ||
[...] | ... | ||
[INFO] BUILD SUCCESS | |||
... | |||
no 'release_repository' defined in ./bin/operations.conf, the binary release available as ./bin/../target/gld-1.0.3.zip ... | |||
setting next local version 1.0.4-SNAPSHOT-1, is this OK? [y/n] y | |||
RELEASE SUMMARY: | |||
A new patch version (1.0.3) was released, committed to repository and tagged. | |||
If you want to create an official GitHub release, use tag "release-1.0.3" and binary gld-1.0.3.zip. | |||
The local version has been incremented to 1.0.4-SNAPSHOT-1. | |||
</pre> | </pre> | ||
</font> | |||
=Make a GitHub Release= | =Make a GitHub Release= | ||
<blockquote style="background-color: Tomato; border: solid thin red;"> | |||
:<br>TODO: automate this with nort: 8.4.1 GitHub Public Release https://kb.novaordis.com/index.php/Nort_Concepts#GitHub_Public_Release<br><br> | |||
</blockquote> | |||
Release | |||
<blockquote style="background-color: #f9f9f9; border: solid thin lightgrey;"> | |||
:[[GitHub_Procedures#Making_a_Public_Release|Making a GitHub Public Release]] | |||
</blockquote> | |||
Latest revision as of 19:52, 28 November 2016
Internal
Procedure
TODO: review all this in the light of the new release procedure nort Concepts#The_Release_Sequence.
Run release Locally
The procedure will:
- increment the version string appropriately
- run tests to make sure that increase in version number does not break functionality
- commit changes
- optionally tag using a tag name convention that uses the release name (snapshot releases are not tagged).
- push
- build the installable release artifact, if the project renders itself to that. This will be referred to as "the binary", and it shall be used as "release binary" at the next step.
At the end of the procedure, the Git tag used to tag the release will be displayed, so it can be used at the next step.
Procedure
release info current version: 1.0.3-SNAPSHOT-4 release patch releasing 1.0.3, is this OK? [y/n] y ... [INFO] BUILD SUCCESS ... git add ok ... git commit ok git tag ok, tagged with release-1.0.3 ... git push ok ... [INFO] BUILD SUCCESS ... no 'release_repository' defined in ./bin/operations.conf, the binary release available as ./bin/../target/gld-1.0.3.zip ... setting next local version 1.0.4-SNAPSHOT-1, is this OK? [y/n] y RELEASE SUMMARY: A new patch version (1.0.3) was released, committed to repository and tagged. If you want to create an official GitHub release, use tag "release-1.0.3" and binary gld-1.0.3.zip. The local version has been incremented to 1.0.4-SNAPSHOT-1.
Make a GitHub Release
TODO: automate this with nort: 8.4.1 GitHub Public Release https://kb.novaordis.com/index.php/Nort_Concepts#GitHub_Public_Release