[camf-dev] Contributing to CAMF through Gerrit

[Nicholas Loulloudes <loulloudes.n@xxxxxxxxxxxx>]

Hi all,

We opted to introduce Gerrit [1] in the development process right from the start so as to familiarize ourselves with code review practices.
This means that every commit, (including the ones from committers) will be up for review prior to being pushed into the main repository.
I know that this might be somewhat cumbersome at the beginning, but I am sure that the overall project outcome will benefit in the end.

For now, the following will assist you in setting up your Eclipse workspace for Gerrit. However, I urge you to take some time and go over
the related material available at the Eclipse wiki [2, 3]. Lars Vogel has also written a good tutorial on Gerrit and Eclipse [4].

• Eclipse Gerrit Setup
  
• Visit web UI: https://git.eclipse.org/r/
• The Gerrit web login uses your email address as your user name combined with your Eclipse.org password.
• Add one or more public SSH keys: https://git.eclipse.org/r/#/settings/ssh-keys
• Enable CAMF project notifications: https://git.eclipse.org/r/#/settings/projects
• Browse for CAMF project name, click 'Watch, and tick all notifications
• Setting up Eclipse
• Start Eclipse and switch over to your CAMF workspace (preferably a clean one)
• Configure EGit Settings
  
• Preferences->Team->Git->Committing
• Enable "Insert Signed-off-by"
• Preferences->Team->Git->Configuration
• Make sure you have the correct user.name and user.email values (the ones registered with Eclipse)
• If empty, check here: https://wiki.eclipse.org/EGit/User_Guide#Identifying_yourself on how to add them
• Configure SSH access
• Preferences->General->Network->SSH2
• Make sure that your SSH2 Home value points to where your private key is located (the one matching the public key added to Gerrit Web UI above)
• Make sure that the 'publickey' preferred method (Authentication Method tab) has the top priority - move up/down accordingly.
  
• Setting up EGit for Gerrit
• CAMF Gerrit repository: ssh://<your_username>@git.eclipse.org:29418/camf/org.eclipse.camf
  
• Follow the steps here: https://wiki.eclipse.org/Gerrit#Using_Gerrit_with_EGit
• After cloning the repo, make sure that the Remotes/origin points to the above repo
• Also make sure that the origin destination (Right click->Gerrit configuration) is: "refs/for/master"
• Import plugins to your workspace

As always, please use the camf-dev mailing list for any further inquiries. Feel free to add anything that I might have missed.

Best,
Nicholas

[1] http://code.google.com/p/gerrit/
[2] https://wiki.eclipse.org/Gerrit#Enabling_Gerrit_for_your_Eclipse.org_Project
[3] https://wiki.eclipse.org/EGit/User_Guide#Working_with_Gerrit
[4] http://www.vogella.com/tutorials/Gerrit/article.html

--

_____________________________________________________________
Nicholas Loulloudes | Eclipse Cloud Application Management Framework
Laboratory for Internet Computing,
Department of Computer Science, University of Cyprus.

Email: loulloudes.n [at] cs.ucy.ac.cy
Web: www.cs.ucy.ac.cy/~nickl
Twitter: @loulloudes
_____________________________________________________________

Attachment: smime.p7s
Description: S/MIME Cryptographic Signature