git-restack/README.md

1.4 KiB

git-review

A git command for submitting branches to Gerrit

git-review is a tool that helps submitting git branches to gerrit for review

Setup

git-review, by default, looks for a git remote called gerrit, and submits the current branch to HEAD:refs/for/master at that remote.

If the "gerrit" remote does not exist, git-review looks for a file called .gitreview at the root of the repository with information about the gerrit remote.

If you want to manually create a gerrit remote, for example, to set it to the OpenStack Compute (nova) project (assuming you have previously signed in to the OpenStack Gerrit server with your Launchpad account), you would do:

USERNAME=jsmith # Launchpad username here
PROJECT=openstack/nova
git remote add gerrit ssh://$USERNAME@review.openstack.org:29418/$PROJECT.git

Usage

Hack on some code, then:

git review

If you want to submit that code to a different target branch, then:

git review branchname

If you want to submit to a different remote:

git review -r my-remote

If you want to supply a review topic:

git review -t topic/awesome-feature

If you want to submit your change to a branch other than master:

git review milestone-proposed

If you want to skip the automatic rebase -i step:

git review -R

If you want to download change 781 from gerrit to review it:

git review -d 781