View source for Gemini/DBAccess/CommitterGuide/HowToUseGerrit

Gerrit is a web based code review system that seamlessly integrates with git. Gerrit is the preferred way to contribute to DBAccess. Using Gerrit at Eclipse.org is desctibed on [[Gerrit]]. The DBAccess specifics and some hints will be described below.

= Accessing Gerrit through your Browser =

The following URL shows you all open changes for the Gemini DBAccess project:

https://git.eclipse.org/r/#/q/status:open+project:gemini.dbaccess/org.eclipse.gemini.dbaccess,n,z

If you want to see all Gerrit changes for DBAccess:

https://git.eclipse.org/r/#/q/project:gemini.dbaccess/org.eclipse.gemini.dbaccess,n,z

= IP Process  =

The IP process for Gerrit is described here: [[Development Resources/Handling Git Contributions#Gerrit]]<br>

= Setup  =

To setup your access to Gerrit follow the documentation [[Gerrit#Logon]]. You should perform the following steps: 

#Add the DBAccess project to the list of projects you watch: https://git.eclipse.org/r/#/settings/projects 
#*Add the the following project name: gemini.dbaccess/org.eclipse.gemini.dbaccess and select all attributs (New Changes, All Comments, Submitted Changes) 
#Upload your SSH public keys to Gerrit if you wish to use SSH: https://git.eclipse.org/r/#/settings/ssh-keys

= Eclipse IDE Configuration  =
The Gerrit code repository can either be accessed via ssh or https. To clone and import the DBAccess project into your workspace, please follow the description [[EGit/User_Guide#Cloning_Remote_Repositories]].

Note: the import can be largly simplified by choosing "Gerrit" in the import wizard at step "Select Repository Source". You then press the "Add" Button. The "Servers" field offers you a drop down list, which contains the "Eclipse.org Reviews" entry. Choose that, and press "Finish". The following screen shows you all projects at Eclipse.org which use the Gerrit code review. You then select "gemini.dbaccess/org.eclipse.gemini.dbaccess" (you can use the filter "dbaccess" to easily find this entry from the list). Just confirm the following dialogs. The result is 
* a workspace that contains all dbaccess projects,
* a local clone of the DBAccess git repository; change to the "Git Repository Exploring" perspective to see the repository.

Depending on the protocol you want to use, the following URIs represent the DBAccess repository:
== SSH == 
ssh://userid@git.eclipse.org:29418/gemini.dbaccess/org.eclipse.gemini.dbaccess.git 
== HTTPS ==
https://git.eclipse.org/r/p/gemini.dbaccess/org.eclipse.gemini.dbaccess.git

= How to Sync a Change from Gerrit  =

In order to sync a change from Gerrit (that has not yet been merge into the git repository), you first need to perform the steps described in the previous sections. Then 
#Change to the "Git Repository Exploring" perspective to see the repository. 
#Choose "Fetch from Gerrit" in the context menu of the repository. 
#Press CTRL-Space to see a filtered list of all Gerrit changes. 
#Choose the change you are interested in.

Your workspace now reflects the state of the selected change. 

<br> <br> --[[User:Juergen.kissner.sap.com|Juergen.kissner.sap.com]] 14:48, 4 April 2012 (UTC) 

[[Category:Gemini_DBAccess|DBAccess]]