ReleaseEngineering/DisposableProjectRepositories
What is a disposable project branch?
These are project branches that can be cloned fresh from any mozilla-central based repo with the full gamut of tests enabled. No l10n or nightlies for now. Similar to TryServer but for longer, and just for you. Unlike Try, the commit level on these branches is level_2 (and above) contributors only so please bear that in mind.
Do you need a disposable branch?
Ask yourself the following:
Does your project have an end date?
If your answer is No then you should follow the process at Project Branch Planning
If your project is a temporary feature sprint that needs its own rapid test coverage but will eventually be merged into mozilla-central and no longer be on its own by all means, please go ahead and
Book one of our fabulous "disposable" project branches
- Sign up below in the BOOKING SCHEDULE
- Make a request to IT to reset the repo for you as a clone from your own project repo (or default mozilla-central:tip). Copy the script below into bug request, replacing the REPO_PATH and TWIG with your repo and booked branch.
export REPO_PATH=[path to your repo] # eg: users/lsblakk_mozilla.com/staging export TWIG=[alder|birch|cedar|holly|larch|maple] # whichever twig you booked cd /repo/hg/scripts/ ./reset_pp_repo.sh -s /repo/hg/mozilla/$REPO_PATH -r tip -d $TWIG
- NOTE: Coordinate with IT when this repo gets reset to push immediately without hitting the webheads. Otherwise, the permissions won't be set correctly.
- Sit back and watch your builds and test results roll in (eg Alder, Birch, Cedar,Holly, Larch, Maple).
- Special note: the first push to your newly cloned repo may not trigger builds if the repo had been pushed to previously, which is bug 774862. If it does not, please re-open the bug and move it to mozilla.org :: Release Engineering with a comment 'Please restart the build scheduler'.
- It will take 3 build runs for the leak checking tools to establish themselves. Before the third run expect to see the builds marked as burning. Other than the leak check the builds should compile and test fine.
When you're done with one of our fabulous "disposable" project branches
Simply clear your data (bug, contact, dates) from the BOOKING SCHEDULE below. If someone is listed in the "Next in Line" column, please let them know you are done.
That's all there is to it!
Using a custom mozconfig
The mozconfigs used for builds live in the same source tree as the main code, eg
- Firefox: browser/config/mozconfigs/<platform>
- Mobile Native: mobile/android/config/mozconfigs/android
- Mobile XUL: mobile/xul/config/mozconfigs/android-xul
The 'nightly' file is used for optimised builds, 'debug' for debug. If you are unsure which file you need consult a build log to see which is used. You can adjust these as needed on your branch, and they will be carried over to mozilla-central when you merge back. Please take care with any mozconfig changes you merge back (eg exclude local conveniences).
Enabling/Disabling of platforms, tests, nightly updates
If you know you won't need some build platforms or tests you can help everyone by not using up machine resources on your pushes. Ask RelEng to disable them by filing a bug here.
Nightly builds and updates are disabled by default but can be enabled on request.
BOOKING SCHEDULE
| Project Branch | Regist. bug | email address of borrower | User/Dev Team contact | Booking Dates | Next in Line |
|---|---|---|---|---|---|
| Alder | - | rjesup@mozilla.com | jesup, anant: WebRTC integration | 2011-09-20 – indefinite | - |
| Ash | bug 801214 bug 801612 | ctalbert@mozilla.com | ctalbert: Staging area for mozharness testing | 2013-04-12 - indefinite | - |
| Birch | - | joduinn@mozilla.com | alternate mozilla-inbound for b2g | 2013-04-10 - | - |
| Cedar | - | aki@mozilla.com | aki: mozharness talos, b2g, pandas, win8, aws testing | 2012-06-25 - indefinite | - |
| Cypress | - | joduinn@mozilla.com | backup mozilla-inbound in case of prolonged closures | 2013-04-26 - | - |
| Date | bug 860246 | glandium@mozilla.com | android x86_64 build environment testing | 2013-04-12 - 2013-05-15 | |
| Elm | - | - | - | - | - |
| Fig | bug 862793, bug 863286 | mleibovic@mozilla.com | margaret: Fennec multipage about:home | 2013-04-18 - 2013-06-01 | - |
| Gum | Cache Work | dougt@mozilla.com | DougT: Cache | 2013-12-31 | |
| Holly | - | - | - | - | - |
| Jamun | bug 847622 | jaws@mozilla.com | Australis Menu and Customization | 2013-03-04 - unknown | - |
| Larch | bug 516752 | billm, dvander | Multi-process browsing | 2013-04-10 - unknown | - |
| Maple | bug 718121 | bhackett@mozilla.com | supersnappy | 5/14/2012 - indefinite | - |
| Oak | bug 790467 | bbondy@mozilla.com | bbondy | 2012-09-11 - 2013-09-11 | - |
| Pine | bug 753113 | badida@mozilla.com | benadida, MattN: Sign in to the browser and identity modules | 2013-04-12 - indefinite | - |
Be sure to keep a copy of anything you need from the repo prior to unbooking it.