Changes

Jump to: navigation, search

Sheriffing/How To/Merges

5,092 bytes added, 08:42, 28 August 2018
no edit summary
{{Sheriffing How To|Merges}}
= Goal =
'''Autoland''' and '''Inbound''' repositories are opened for developers who work on bug fixes, improvements and other. Usually, '''twice a day''', clean code is transferred form Autoland and Inbound to Central, and back. <br /><span style="color:#14866d">'''''No sync is performed, only differences are transferred (merge).'''''</span> Merges are done between <span style="color:#FF0000">'''8:00 PM – 10 PM''' UTC</span> and <span style="color:#FF0000">'''8 AM – 10 AM'''</span>. At <span style="color:#FF0000">'''11AM'''</span> and <span style="color:#FF0000">'''11PM'''</span> UTC time, <span style="color:#FF0000">'''Nightly builds start'''</span> (they take between 2 to 4 hours to build) and it’s desired to transfer as much clean code as possible. Ideally, merges should be done before 10 AM/PM UTC time to be able to fix bad code before Nightly builds start. Each sheriff should perform a merge at the beginning of their work day. Effectively, this results in two sets of merges every day to/from autoland and mozilla-inbound to mozilla-central. <span style="color:#FF0000">'''Note'''</span>: in winter Nightlies, always start at <span style="color:#FF0000">12PM/AM Romanian time</span> (+1 or 2 minutes after that), so having merges done before that helps with getting the changes into these builds. How long it takes to merge depends, mostly on merge conflicts. 
= Choosing a changeset to merge =
For merges from the integration trees to mozilla-central, you should choose a changeset with a green PGO run to avoid bustages on nightly builds that also run PGO. You need to also make sure that are *NOT* any backouts *after* that changeset.
 
'''A more in depth view of the conditions a merge candidate must fulfill:'''
#Candidate revision must be <span style="color:#14866d">'''100% completed'''</span> or <span style="color:#14866d">'''at least 98-99%'''</span>, with <span style="color:#14866d">'''maximum 15 jobs running'''</span>.
#<span style="color:#FF0000">'''No jobs classified as fixed by commit'''</span>
#'''Few''' or '''no unclassified''' jobs
#Windows 7 pgo platform must have <span style="color:#14866d">'''all jobs finished'''</span> (32 minimum – M-e10s, see screenshot as an example) [[File:Pgo tests.png|frame|center]]
#No backouts after merge candidate
#If a merge candidate has more than 15 jobs running but they are autophone jobs, the candidate is good to use
 
= Order of operations =
Integration branches should be merged to mozilla-central first, then mozilla-central should be merged back to the integration branches. These merge instructions were copied from [[Sheriffing/How:To:SheriffingFromUnifiedRepos#Merges|Sheriffing From Unified Repos]] document.
 
'''Merge pattern:'''
# autoland > central
# inbound > central
# central > autoland
# central > inbound
== Merging from autoland and mozilla-inbound to mozilla-central ==
Example Steps on how to do the <span style="color:#14866d">'''autoland to mozilla-central'''</span> AND <span style="color:#14866d">'''mozilla-inbound to mozilla-central '''</span> merge: # Have your revision ids ready# In the console switch to Mozilla-unified directory: <code>cd mozilla-unified</code> # Download the Central repo: <code>hg pull central</code> # Switch and update to it: <code>hg update central</code> # Autoland to central merge command: <code>hg merge -r <changesetspan style="color:#14866d"><autoland_revision_id></span> </code># Add a commit message: <code>hg commit -m "Merge autoland to mozilla-central. a=merge"</code># Transfer the green changeset with PGO runs on mozillafiles to Central repo: <code>hg push -r . central</code># Inbound to Central merge command: <code>hg merge -inboundr <span style="color:#14866d"><inbound_revision_id></span></code> # Add a commit message: <code>hg commit -m "Merge inbound to mozilla-central. a=merge"</code> # Transfer the files to Central repo: <code>hg push -r . central</code> After the merges are in Central, <span style="color:#FF0000">'''bugs need to be marked with Bugherder'''</span>: go to Central and in the top right side of each of your pushes to Central, click on '''Action Menu''' (arrow button next to the pin button) and choose '''Mark With Bugherder'''.[[File:Bugherder tool.png|frame|center]]Navigate through all the pages, check for any security bugs that can’t be updated by Bugherder and mention them to someone who can, check that Resolve and Fixed checkboxes are ticked and the correct version is set. At the last step click '''Submit''' and use your '''API key''' to finish the process. Leave the tab opened until the loadbar is not displayed anymore.
After you, be sure to use Bugherder to classify any failures on your merge commit. It<span style="color:#14866d">'''s available from Monitor the menu for pushes and check that the push on [https://treeherderGecko Decision Task opt job is running.mozillaIf it fails, retrigger it, if it fails again the tree should be closed and the issue escalated.org/#/jobs?repo=mozilla-central Treeherder]'''</span>
== Merging back from mozilla-central to autoland and mozilla-inbound ==
Example Steps on how to do the <span style="color:#14866d">'''mozilla-central to autoland'''</span> AND <span style="color:#14866d">'''mozilla-central to inbound '''</span> merge: # Close inbound and autoland from [https://mozilla-releng.net/treestatus Treestatus] # In the console switch to Mozilla-unified directory: <code>cd mozilla-unified</code> # Download the repos: <code>hg pullfxtrees</code># Update autoland: <code>hg update autoland</code># Merge from central to autoland: <code>hg merge central</code># Add a commit message: <code>hg commit -m "Merge mozilla-central to autoland. a=merge CLOSED TREE"</code># Transfer the files to Autoland: <code>hg push -r . autoland</code># Update inbound: <code>hg update inbound</code> # Merge from central to inbound: <code>hg merge central</code> # Add a commit messagel: <code>hg commit -m "Merge mozilla-central to mozilla-inbound. a=merge CLOSED TREE"</code> # Transfer the files to inbound: <code>hg push -r . inbound </code> 
These commands *might* result in race conditions on the tree when it is busy. Under those circumstances, this commands avoid delays between steps:
cd mozilla-unified
hg pull && hg update inbound && hg merge central && hg commit -m "Merge mozilla-central to mozilla-inbound" && hg push -r . inbound
 
<span style="color:#FF0000">'''Note'''</span>: For correcting a commit message, use <code>hg commit --amend</code>
=== When there is nothing to merge ===
<code>mozilla.check.webidl_check = false</code>
 
== How to run Bugherder if the tool is not working ==
 
# Go to https://bugherder.mozilla.org/
# Save the whole page ('''menu File > Save Page As > complete page''')
# Save it as bugherder.htm
# In the folder '''"bugherder_files"''', you will find the file: <span style="color:#FF0000">'''bz-0.js'''</span>. Open that with an editor
# Go to <span style="color:#FF0000">'''line 265'''</span> and change the url to https://bugzilla.mozilla.org/latest/configuration
# Save the file
# Open bugherder.htm in the browser
# Type in the '''revision number from central''' (first autoland revision and then mozilla-inbound revision), hit submit
# Check to see if everything is ok and submit the changes
NataliaCs
Confirm
79
edits
Retrieved from "https://wiki.mozilla.org/Special:MobileDiff/1200133"

Navigation menu