canmove, Confirmed users
6,441
edits
User:Bhearsum/Release Automation Documentation: Difference between revisions
User:Bhearsum/Release Automation Documentation (view source)
Revision as of 17:31, 25 February 2011
, 25 February 2011→Configuration
(Created page with "== Notes and Definitions == * 'Staging server' typically means stage.mozilla.org for production (read: real) releases and staging-stage.build.mozilla.org for staging (read: test)...") |
|||
| Line 40: | Line 40: | ||
The release configs themselves have a number of variables and options in them. These are discussed below. | The release configs themselves have a number of variables and options in them. These are discussed below. | ||
==== sourceRepositories ==== | |||
This variable is information dense dictionary and mostly contains information only relevant to Tagging. | |||
Each key of sourceRepositories (eg. "mozilla"), has a value of a dict with the following structure: | |||
* name - The name of the source repository, without any leading directories | |||
* clonePath - (staging only) Where to clone this repository from in repo_setup | |||
* path - Where to clone this repository for everything else (tagging, builds, repacks, et. al) | |||
* revision - The revision to base this release on. If relbranch is None or the provided one does not exist, the automation will update to this revision before creating the relbranch. | |||
* relbranch - The name of the relbranch to use for this release. If set to None, it will be generated automatically. If provided and exists, the automation will update to it before doing any bumping or tagging. If provided and doesn't exist, it will be created. | |||
* bumpFiles - This is another dict, whose keys are the paths in the sourceRepo, and whose values are *another* dict, with the following structure. | |||
** version - The version number to use in this file on the relbranch | |||
** nextVersion - The version number to use in this file on the default branch | |||
Here's a concrete example of sourceRepositories for a Firefox build. Note that the bump file versions are typically factored out to earlier variables to avoid repetition. | |||
<pre> | |||
releaseConfig['sourceRepositories'] = { | |||
'mozilla': { | |||
'name': 'mozilla-central', | |||
'path': 'mozilla-central', | |||
'revision': 'aaaaabbbbcccc', | |||
'relbranch': None | |||
'bumpFiles': { | |||
'browser/config/version.txt': { | |||
'version': releaseConfig['appVersion'], | |||
'nextVersion': releaseConfig['nextAppVersion'], | |||
}, | |||
'config/milestone.txt': { | |||
'version': releaseConfig['milestone'], | |||
'nextVersion': releaseConfig['nextMilestone'], | |||
}, | |||
} | |||
} | |||
} | |||
</pre> | |||
==== Others ==== | |||
{| class="fullwidth-table" | {| class="fullwidth-table" | ||
| '''Variable''' | | '''Variable''' | ||