Revision as of 11:52, 16 January 2013

Configuring the repository

This guide outlines a number of command line instructions. They can be followed on either linux or windows, use a console (linux) or msysgit (windows).

Creating a User Account

• You need an Eclipse user account. You already have one if you are an Eclipse commiter or have a Bugzilla account. Otherwise, use this form.
• You should now be able to logon to the Gerrit Web UI (top-right corner of the page) using the email address you registered with your Eclipse (and/or Bugzilla) account and your Eclipse password.

Update repository information

Your user name and email should match the information you've provided to Eclipse. From the command line, use the following (change any <bold> text to your own info) :

$ cd <path/to/repository>
$ git config --local user.name "<Full Name>"
$ git config --local user.email "<your.mail@yourmail.com>"

SSH

• Your username is what is displayed in Gerrit.
• You need to upload your public SSH key here. Follow the instructions below if you do not know how.

Generating and uploading SSH keys

First of all, please follow the guide on Github up to (and excluding) Step 4.

You now have a public SSH key, you need to upload it to gerrit.

First, use the following command :

$ clip < ~/.ssh/id_rsa.pub

This will copy your full SSH key in the clipboard.

Then, in the settings of Gerrit, click "Add Key".

Do not enter anything manually, simply right-click the text field that appears and select "Paste". Click the Add button without changing the pasted text.

Adding a new remote

Using the command line or msysgit, use the following (change any bold text to your own info, remember that your username is displayed here) :

$ cd <path/to/repository>
$ git config remote.review.url ssh://<username>@git.eclipse.org:29418/emfcompare/org.eclipse.emf.compare.git
$ git config remote.review.push HEAD:refs/for/master

This will allow you to push review request on the Gerrit of EMF Compare using only :

$ git push review

You are still missing a bit of configuration though.

Requesting a Review

Your commit message must follow the proper guidelines PENDING

And it needs to contain a change ID.