ReleaseEngineering:ProjectBranchPlanning

If your need for an automated branch is of a known length of time, please book a Disposable Project Branch, otherwise if you are looking for a longer term solution and want a new project branch created for your work, please file a bug with this bug template

Copy the questions below, and insert your answers in the bug's comment section so we have the info we need:

• Project name:
  • Your project name will also be used for the repo name (eg: hg.mozilla.org/projects/jaegermonkey) - please state if you have an existing repo you're looking to use instead of a projects/ one.
  • Note: project names should avoid using confusing/overloaded terms, like "build", "firefox", "release"...

• For builds:
  • All platforms or subset of platforms currently building mozilla-central?
  • Will you use the mozilla-central mozconfigs or will you need custom ones?
  • Nightly builds?

• Need unittests?
  • All platforms or subset of platforms currently testing mozilla-central?

• Mobile Builds?
  • All platforms or subset of platforms currently building mobile-browser?

• Need Talos?
  • All talos suites or a subset of suites run on mozilla-central?

• Name of the contact person for this branch who will:
  • Be doing periodic refreshes from parent
  • Be contact person for misc setup questions
  • Decide when to land back project branch onto parent
  • Decide when to terminate the project branch

• Timeline:
  • When should this branch go live?
  • Approx expected life span of project branch?

Release Engineering Project Branch Creation Checklist

• File a ServerOps bug to create repo in hg.m.o if repo does not already exist. Repos should be created under "/projects", "/services" or "/releases" whenever possible.
• Create tinderbox page for the branch to report to
• Create a patch on tbpl to add the branch to tbpl (currently the reviewer of choice is Ehsan)
• Once that is reviewed and landed you can Update TBPL
• Create patches in buildbot-configs/mozilla/project_branches adding the project and if needed any custom mozconfig path or custom repo path
  • Example customization is turning on nightly updates, if this comes up you can copy the process from the UX branch see bug 642536 for what is required wrt AUS
• Do an update to branch and machines tables in graphs/sql/data.sql (branch 1.0 of this repo)
• File a ServerOps bug (example bug 633663) to add graphserver entries until this is automated (see bug 627499)
• Add to self-serve (instructions)

Once the above items are done and a few pushes have gone through without issue, close the bug - you're done!

Additional Steps For Adding Release Branches

• File IT bugs:
  • to add Nagios monitoring on checks for file age in firefox/nightly/latest-$branch if required
  • to add mxr indexing (release branches only - see bug 510495 for example)
• File a Webtools/Socorro bug to add the new branch to vcsMappings:
  • This allows devs to get source links for branch crash reports.
  • Ask for this:

'hg.mozilla.org/REPO' => 'http://hg.mozilla.org/REPLACE_WITH_REPO/annotate/%(revision)s/%(file)s#l%(line)s'

• Make sure to add mozconfigs for each platform!

Brief Note about Unittests