Gerrit Staging Commands: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
 
No edit summary
Line 1: Line 1:
=Gerrit staging commands=
[[Category:Developing_Qt::Gerrit]]


==Overview==
[toc align_right="yes" depth="2"]


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 Introduction#a08363df2815db284c1d8e68994b5522|integration step]] ''[qt.io]''.
= Gerrit staging commands =


The version of gerrit that is running on codereview.qt.io has been modified from the original code base. These changes are available [http://qt.io/ here] ''[qt.io]''
== Overview ==


==Staging List==
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.
This lists all the commits that have been applied to the staging branch.


==Staging Pass==
<code>gerrit staging-ls -p &lt;gerrit project&amp;gt; -b &lt;source branch&amp;gt; -d &lt;destination&amp;gt;<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.
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.


==Staging Fail==
</code>gerrit staging-approve -p &lt;gerrit project&amp;gt; -i &lt;gerrit build&amp;gt; -b &lt;source branch&amp;gt; -r pass -m &lt;message&amp;gt; </code>


This is the integration fail command that cancels currently integrating commits and changes gerrit status back to ‘review in progress’.
== Staging Fail ==


==Staging New Build==
This is the integration fail command that cancels currently integrating commits and changes gerrit status back to 'review in progress'.


This creates a new build and places all the currently staged commits into a unique build branch and changes the gerrit status to <span class="caps">INTEGRATING</span>.
<code>gerrit staging-approve -p &lt;gerrit project&amp;gt; -i &lt;gerrit build&amp;gt; -b &lt;source branch&amp;gt; -r fail -m &lt;message&amp;gt; <code>


==<span class="caps">SSH</span> Access==
== Staging New Build ==


Access to these commands are typically handled via an <span class="caps">SSH</span> connection to the gerrit server on qt.io. This through port 29418 to codereview.qt.io with the following syntax
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 Help==
</code>gerrit staging-new-build -p &lt;gerrit project&amp;gt; -s &lt;source branch&amp;gt; -i &lt;gerrit build id&amp;gt; </code>


To obtain a printout of help from gerrit there is a help option that can be passed to the server.
== 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
 
<code>ssh -p 29418 codereview.qt.io gerrit &lt;gerrit command/options&amp;gt;<code>


==More information==
== Gerrit Help ==


Refer to the [http://gerrit.googlecode.com/svn/documentation/2.0/cmd-index.html gerrit command documentation] ''[gerrit.googlecode.com]'' for more information
To obtain a printout of help from gerrit there is a help option that can be passed to the server.


===Categories:===
</code>ssh -p 29418 codereview.qt.io gerrit —help</code>


* [[:Category:Developing Qt|Developing_Qt]]
== More information ==
** [[:Category:Developing Qt::Gerrit|Gerrit]]

Revision as of 10:24, 24 February 2015


[toc align_right="yes&quot; depth="2&quot;]

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&quot;: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&quot;:http://qt.io/

Staging List

This lists all the commits that have been applied to the staging branch.

gerrit staging-ls -p &lt;gerrit project&amp;gt; -b &lt;source branch&amp;gt; -d &lt;destination&amp;gt;<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&gt; -i <gerrit build&gt; -b <source branch&gt; -r pass -m <message&gt;

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 &lt;gerrit project&amp;gt; -i &lt;gerrit build&amp;gt; -b &lt;source branch&amp;gt; -r fail -m &lt;message&amp;gt; <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&gt; -s <source branch&gt; -i <gerrit build id&gt;

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 &lt;gerrit command/options&amp;gt;<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

More information