# That you have already configured the Git repository you wish to use Gerit with, and that Gerrit has been enabled on the repository. If you have not cloned a repository yet, try viewing the How To page for [[Orion/How Tos/Working with git|working with Git]]

+

# That you have already configured the Git repository you wish to use Gerrit with, and that Gerrit has been enabled on the repository. If you have not cloned a repository yet, try viewing the How To page for [[Orion/How Tos/Working with git|working with Git]]

# That you are working with the Orion repositories, as all of the screen shots and examples will mention those repositories exclusively. If you are not trying to set up Gerrit for the Orion repositories, the steps will be generally the same but the URLs will differ.

# That you are working with the Orion repositories, as all of the screen shots and examples will mention those repositories exclusively. If you are not trying to set up Gerrit for the Orion repositories, the steps will be generally the same but the URLs will differ.

# That you have a valid Eclipse.org log-in and will not be using anonymous access to Gerrit

# That you have a valid Eclipse.org log-in and will not be using anonymous access to Gerrit

Line 17:

Line 17:

On the [https://git.eclipse.org/r/#/admin/projects/orion/org.eclipse.orion.client Orion client project page] there will be different URL information for how to set up your remote. At the top of the information page you will see a URL like <code>ssh://git.eclipse.org:29418/orion/org.eclipse.orion.client</code>. Copy this URL, we will use it in the next step.

On the [https://git.eclipse.org/r/#/admin/projects/orion/org.eclipse.orion.client Orion client project page] there will be different URL information for how to set up your remote. At the top of the information page you will see a URL like <code>ssh://git.eclipse.org:29418/orion/org.eclipse.orion.client</code>. Copy this URL, we will use it in the next step.

−

== Setting up the Gerrit remote ==

+

= Configure the Gerrit remote =

Once you are logged into the Orion client, use the navigation menu to open the Git repositories view. Assuming have already cloned the Orion client repository, lets add the Gerrit remote.

Once you are logged into the Orion client, use the navigation menu to open the Git repositories view. Assuming have already cloned the Orion client repository, lets add the Gerrit remote.

Line 23:

Line 23:

# Expand that section and click the '''New Remote''' button on the right hand side

# Expand that section and click the '''New Remote''' button on the right hand side

# In the '''Name''' box supply a meaningful name, such as <code>gerrit</code>

# In the '''Name''' box supply a meaningful name, such as <code>gerrit</code>

−

# In the URL box enter the URL fro the Gerrit project page, in this case it will be <code>ssh://git.eclipse.org:29418/orion/org.eclipse.orion.client</code>[[Image:gerrit-orion-remote.png|The new remote entry example for the Orion client]]

+

# In the URL box enter the URL fro the Gerrit project page, in this case it will be <code>ssh://git.eclipse.org:29418/orion/org.eclipse.orion.client</code><br>[[Image:gerrit-orion-remote.png|The new remote entry example for the Orion client]]

# Press '''Submit''' and you should see your new Gerrit remote

# Press '''Submit''' and you should see your new Gerrit remote

# In the '''Configuration''' section select the <code>View all</code> link on the right hand side

# In the '''Configuration''' section select the <code>View all</code> link on the right hand side

# Find the '''remote.gerrit.fetch''' setting and change it to be <code>refs/notes/*:refs/notes/*</code>

# Find the '''remote.gerrit.fetch''' setting and change it to be <code>refs/notes/*:refs/notes/*</code>

−

# Using the '''New Configuration Entry''' button on the right hand side and the new entry <code>remote.gerrit.push</code> and set its value to be <code>HEAD:refs/for/master</code> [[Image:gerrit-gerrit-push-entry.png|The new gerrit push configuration entry]]

+

# Using the '''New Configuration Entry''' button on the right hand side and the new entry <code>remote.gerrit.push</code> and set its value to be <code>HEAD:refs/for/master</code><br>[[Image:gerrit-gerrit-push-entry.png|The new gerrit push configuration entry]]

# Head back to the '''Remotes''' section and do a pull on the <code>gerrit</code> remote to make sure it is working.

# Head back to the '''Remotes''' section and do a pull on the <code>gerrit</code> remote to make sure it is working.

Revision as of 10:15, 8 January 2014

Contents

Introduction

This How To makes a few assumptions:

That you have already configured the Git repository you wish to use Gerrit with, and that Gerrit has been enabled on the repository. If you have not cloned a repository yet, try viewing the How To page for working with Git

That you are working with the Orion repositories, as all of the screen shots and examples will mention those repositories exclusively. If you are not trying to set up Gerrit for the Orion repositories, the steps will be generally the same but the URLs will differ.

That you have a valid Eclipse.org log-in and will not be using anonymous access to Gerrit

Get the Gerrit information

To use Gerrit you have to set up another remote for your repository that points to the Gerrit instance.