Gerrit Staging Commands: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
[[Category:Developing_Qt::Gerrit]] | [[Category:Developing_Qt::Gerrit]] | ||
[toc align_right= | [toc align_right="yes" depth="2"] | ||
= Gerrit staging commands = | = Gerrit staging commands = | ||
| Line 7: | Line 7: | ||
== Overview == | == Overview == | ||
Gerrit provides a command line interface to handle staging related activities. These commands provide a mechanism for viewing and managing the status of gerrit branches. This can be as simple as listing the currently staged items associated with a project/branch, the creation of a new build for a project/branch and the status setting of staged items that have passed or failed some | Gerrit provides a command line interface to handle staging related activities. These commands provide a mechanism for viewing and managing the status of gerrit branches. This can be as simple as listing the currently staged items associated with a project/branch, the creation of a new build for a project/branch and the status setting of staged items that have passed or failed some "integration step":http://wiki.qt.io/Gerrit_Introduction#a08363df2815db284c1d8e68994b5522. | ||
The version of gerrit that is running on codereview.qt.io has been modified from the original code base. These changes are available | The version of gerrit that is running on codereview.qt.io has been modified from the original code base. These changes are available "here":http://qt.io/ | ||
== Staging List == | == Staging List == | ||
| Line 15: | Line 15: | ||
This lists all the commits that have been applied to the staging branch. | This lists all the commits that have been applied to the staging branch. | ||
<code>gerrit staging-ls -p | <code>gerrit staging-ls -p <gerrit project> -b <source branch> -d <destination><code> | ||
== Staging Pass == | == Staging Pass == | ||
| Line 21: | Line 21: | ||
This is the integration approval command that merges all staged and currently integrating commits into the master branch and changes the gerrit status to merged. | This is the integration approval command that merges all staged and currently integrating commits into the master branch and changes the gerrit status to merged. | ||
</code>gerrit staging-approve -p | </code>gerrit staging-approve -p <gerrit project> -i <gerrit build> -b <source branch> -r pass -m <message> </code> | ||
== Staging Fail == | == Staging Fail == | ||
| Line 27: | Line 27: | ||
This is the integration fail command that cancels currently integrating commits and changes gerrit status back to 'review in progress'. | This is the integration fail command that cancels currently integrating commits and changes gerrit status back to 'review in progress'. | ||
<code>gerrit staging-approve -p | <code>gerrit staging-approve -p <gerrit project> -i <gerrit build> -b <source branch> -r fail -m <message> <code> | ||
== Staging New Build == | == Staging New Build == | ||
| Line 33: | Line 33: | ||
This creates a new build and places all the currently staged commits into a unique build branch and changes the gerrit status to INTEGRATING. | This creates a new build and places all the currently staged commits into a unique build branch and changes the gerrit status to INTEGRATING. | ||
</code>gerrit staging-new-build -p | </code>gerrit staging-new-build -p <gerrit project> -s <source branch> -i <gerrit build id> </code> | ||
== SSH Access == | == SSH Access == | ||
| Line 39: | Line 39: | ||
Access to these commands are typically handled via an SSH connection to the gerrit server on qt.io. This through port 29418 to codereview.qt.io with the following syntax | Access to these commands are typically handled via an SSH connection to the gerrit server on qt.io. This through port 29418 to codereview.qt.io with the following syntax | ||
<code>ssh -p 29418 codereview.qt.io gerrit | <code>ssh -p 29418 codereview.qt.io gerrit <gerrit command/options><code> | ||
== Gerrit Help == | == Gerrit Help == | ||
Revision as of 10:44, 25 February 2015
[toc align_right="yes" depth="2"]
Gerrit staging commands
Overview
Gerrit provides a command line interface to handle staging related activities. These commands provide a mechanism for viewing and managing the status of gerrit branches. This can be as simple as listing the currently staged items associated with a project/branch, the creation of a new build for a project/branch and the status setting of staged items that have passed or failed some "integration step":http://wiki.qt.io/Gerrit_Introduction#a08363df2815db284c1d8e68994b5522.
The version of gerrit that is running on codereview.qt.io has been modified from the original code base. These changes are available "here":http://qt.io/
Staging List
This lists all the commits that have been applied to the staging branch.
gerrit staging-ls -p <gerrit project> -b <source branch> -d <destination><code>
== Staging Pass ==
This is the integration approval command that merges all staged and currently integrating commits into the master branch and changes the gerrit status to merged.
gerrit staging-approve -p <gerrit project> -i <gerrit build> -b <source branch> -r pass -m <message>
Staging Fail
This is the integration fail command that cancels currently integrating commits and changes gerrit status back to 'review in progress'.
gerrit staging-approve -p <gerrit project> -i <gerrit build> -b <source branch> -r fail -m <message> <code>
== Staging New Build ==
This creates a new build and places all the currently staged commits into a unique build branch and changes the gerrit status to INTEGRATING.
gerrit staging-new-build -p <gerrit project> -s <source branch> -i <gerrit build id>
SSH Access
Access to these commands are typically handled via an SSH connection to the gerrit server on qt.io. This through port 29418 to codereview.qt.io with the following syntax
ssh -p 29418 codereview.qt.io gerrit <gerrit command/options><code>
== Gerrit Help ==
To obtain a printout of help from gerrit there is a help option that can be passed to the server.
ssh -p 29418 codereview.qt.io gerrit —help