25
edits
Changes
add a new page about how to submit an uplift request
== Requesting an Uplift ==
Requesting a patch uplift is completed using the standard Mozilla code review and landing tools and processes. Creating an uplift request can be done either:
* By finding the patch in your local VCS and submitting via ''moz-phab''.
* By finding the patch on Phabricator and submitting via Lando.
After submitting the patch stack via either method, you must complete the Uplift Request form on the tip of the patch stack. This will request review from Release Management.
=== Requesting Uplift using ''moz-phab'' ===
# '''Find the patch or series of patches in your local VCS.''' You can ''moz-phab patch'' onto your local machine if need be.
# '''Determine which uplift train you want to request an uplift for.''' You can see which trains are available with ''moz-phab uplift –list-trains''.
# '''Run ''moz-phab uplift <revset of patches> –train <train>''.''' Most of the arguments to ''moz-phab uplift'' are the same as ''moz-phab submit''. This will create new revisions in Phabricator that will be uplifted to the specified train. If ''moz-phab uplift'' is run from mozilla-unified, the stack of patches will be rebased onto the target that will be landed to. For example if you specify ''--train beta'', the patches will be rebased onto the ''beta'' head in your local VCS. If ''moz-phab uplift'' is run from central or another non-unified repo, the commits will be submitted without attempting to rebase them.
# '''Open the URL as suggested at the bottom of the output.'''
# '''Complete the uplift request form. See the section below on how to submit the form.'''
=== Requesting Uplift using Lando ===
# '''Go to the Lando page for the stack of revisions to uplift.''' Note: the maximum stack size for use in the web UI is 5 patches. Please use moz-phab to submit larger patch stacks. You can get here from the Phabricator revision by using the “View stack in Lando” option on the right side menu.
# '''Log in to Lando.''' Click the Log In button in the top right.
# '''Add your Phabricator API token and save changes.''' Click your username in the top right corner and paste the Phabricator API token there. Tokens are in the form ''api-XXXXX…''. This token can be found here (replace <USERNAME> with your phab username): https://phabricator.services.mozilla.com/settings/user/<USERNAME>/page/apitokens/
# '''Click the “Preview Landing” button. There should be a new button on the bottom right of the modal that is shown.''' Select the target repo (beta) from the list and click “request uplift” See bottom right.
# '''Complete the uplift request form. See the section below on how to submit the form.'''
=== Submit the Uplift Request Form ===
Once your revision is created in Phabricator, you must complete the uplift request form. This form is a short questionnaire that helps Release Managers understand the reasoning behind the uplift request and the risk associated with this patch landing directly on a release repository without riding the release trains.
# '''Go to a revision in the uplift request stack.'''
# '''Navigate to the bottom of the page where you would “approve” or “request changes” for a patch and select “Change uplift request form”.'''
# '''Complete the form and press “request uplift”.'''
# '''Wait for Release Manager approval.''' If the patch stack does not apply cleanly to the uplift train due to a merge conflict, you may need to resolve merge conflicts and re-submit the stack.
Requesting a patch uplift is completed using the standard Mozilla code review and landing tools and processes. Creating an uplift request can be done either:
* By finding the patch in your local VCS and submitting via ''moz-phab''.
* By finding the patch on Phabricator and submitting via Lando.
After submitting the patch stack via either method, you must complete the Uplift Request form on the tip of the patch stack. This will request review from Release Management.
=== Requesting Uplift using ''moz-phab'' ===
# '''Find the patch or series of patches in your local VCS.''' You can ''moz-phab patch'' onto your local machine if need be.
# '''Determine which uplift train you want to request an uplift for.''' You can see which trains are available with ''moz-phab uplift –list-trains''.
# '''Run ''moz-phab uplift <revset of patches> –train <train>''.''' Most of the arguments to ''moz-phab uplift'' are the same as ''moz-phab submit''. This will create new revisions in Phabricator that will be uplifted to the specified train. If ''moz-phab uplift'' is run from mozilla-unified, the stack of patches will be rebased onto the target that will be landed to. For example if you specify ''--train beta'', the patches will be rebased onto the ''beta'' head in your local VCS. If ''moz-phab uplift'' is run from central or another non-unified repo, the commits will be submitted without attempting to rebase them.
# '''Open the URL as suggested at the bottom of the output.'''
# '''Complete the uplift request form. See the section below on how to submit the form.'''
=== Requesting Uplift using Lando ===
# '''Go to the Lando page for the stack of revisions to uplift.''' Note: the maximum stack size for use in the web UI is 5 patches. Please use moz-phab to submit larger patch stacks. You can get here from the Phabricator revision by using the “View stack in Lando” option on the right side menu.
# '''Log in to Lando.''' Click the Log In button in the top right.
# '''Add your Phabricator API token and save changes.''' Click your username in the top right corner and paste the Phabricator API token there. Tokens are in the form ''api-XXXXX…''. This token can be found here (replace <USERNAME> with your phab username): https://phabricator.services.mozilla.com/settings/user/<USERNAME>/page/apitokens/
# '''Click the “Preview Landing” button. There should be a new button on the bottom right of the modal that is shown.''' Select the target repo (beta) from the list and click “request uplift” See bottom right.
# '''Complete the uplift request form. See the section below on how to submit the form.'''
=== Submit the Uplift Request Form ===
Once your revision is created in Phabricator, you must complete the uplift request form. This form is a short questionnaire that helps Release Managers understand the reasoning behind the uplift request and the risk associated with this patch landing directly on a release repository without riding the release trains.
# '''Go to a revision in the uplift request stack.'''
# '''Navigate to the bottom of the page where you would “approve” or “request changes” for a patch and select “Change uplift request form”.'''
# '''Complete the form and press “request uplift”.'''
# '''Wait for Release Manager approval.''' If the patch stack does not apply cleanly to the uplift train due to a merge conflict, you may need to resolve merge conflicts and re-submit the stack.
