Update release history and process docs

This commit is contained in:
James Laska
2014-11-25 11:53:41 -05:00
parent d47d2f5700
commit 36992e47ce
2 changed files with 28 additions and 7 deletions

View File

@@ -1,21 +1,38 @@
Release Process
===============
This document describes the process of created and publishing an Ansible Tower release.
This document describes the process of creating and publishing an Ansible Tower release.
Time for a release
------------------
When the time comes for a release, the first step is to tag the release in git.
When the time comes for a release, the following steps will ensure a smooth and
successful release.
1. Verify that the `__version__` variable has been updated in `awx/__init__.py`.
__version__ = 'X.Y.Z'
2. Update the rpm package changelog by adding a new entry to the file `packaging/rpm/ansible-tower.spec`.
3. Update the debian package changelog by adding a new entry to the file `packaging/debian/changelog`.
4. Tag and push the release to git.
# git tag <X.Y.Z>
# git push --tags
5. Create and push a release branch to git.
# git branch release_<X.Y.Z>
# git checkout release_<X.Y.Z>
# git push origin release_<X.Y.Z>
Monitor Jenkins
---------------
Once tagged, [Jenkins](http://50.116.42.103/view/Tower/) will take care of the
following steps. The jenkins job
[Release_Tower](http://50.116.42.103/view/Tower/job/Release_Tower/) will detect
the recent tag, and initiate the `OFFICIAL=yes` build process.
Once tagged, one must launch the [Release_Tower](http://50.116.42.103/view/Tower/job/Release_Tower/) with the following parameters:
* `GIT_BRANCH=origin/tags/<X.Y.Z>`
* `OFFICIAL=yes`
The following jobs will be triggered:
* [Build_Tower_TAR](http://50.116.42.103/view/Tower/)