Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "WTP Gerrit Access"

(References)
(21 intermediate revisions by 6 users not shown)
Line 15: Line 15:
 
= Upload the SSH2 public key  =
 
= Upload the SSH2 public key  =
 
# Log on to [https://git.eclipse.org/r/#/settings/ssh-keys Eclipse Git repository] with your Eclipse id
 
# Log on to [https://git.eclipse.org/r/#/settings/ssh-keys Eclipse Git repository] with your Eclipse id
# Click the '''Add Key...''' button to open the dialog
+
# Click the '''Add Key...''' button to open the dialog[[File:UploadPublicKey.PNG]]
 
# Paste the public key copied from the Eclipse preferences page to the public key area
 
# Paste the public key copied from the Eclipse preferences page to the public key area
 
# Click the '''Add''' button to close the dialog
 
# Click the '''Add''' button to close the dialog
Line 21: Line 21:
 
= Clone a repository for development  =
 
= Clone a repository for development  =
  
After enabling Gerrit for WTP Git repositories, the existing access URLs, for instance ssh://userid@git.eclipse.org/gitroot/jeetools/webtools.javaee.git,  become ready only. A new URL, ssh://userid@git.eclipse.org:29418/jeetools/webtools.javaee.git is created for pushing the change set.  
+
With Gerrit enabled, ''gitroot'' URLs like ssh://''${GITUSER}''@git.eclipse.org/gitroot/jeetools/webtools.javaee.git are ready only.  
  
Please use the following URLs to access the repositories to push the change set.
+
Push changes to Gerrit on port 29418: ssh://''${GITUSER}''@git.eclipse.org:29418/jeetools/webtools.javaee.git.
  
#'''ssh://userid@git.eclipse.org/gitroot/webtools-common/webtools.common.git'''
+
Here's the complete list of current repos, as of 2017-06-15. This list is subject to change as new repos are created or existing repos are merged.  
#'''ssh://userid@git.eclipse.org/gitroot/webtools-common/webtools.common.fproj.git'''
+
 
#'''ssh://userid@git.eclipse.org/gitroot/webtools-common/webtools.common.snippets.git'''
+
<source lang="bash">
#'''ssh://userid@git.eclipse.org/gitroot/webtools-common/webtools.common.tests.git'''
+
GITUSER=YOUR_ECLIPSE_GITUSER
#'''ssh://userid@git.eclipse.org:29418/jeetools/webtools.javaee.git'''
+
git clone ssh://${GITUSER}@git.eclipse.org:29418/webtools-common/webtools.common.git
#'''ssh://userid@git.eclipse.org:29418/jeetools/webtools.javaee.tests.git'''
+
git clone ssh://${GITUSER}@git.eclipse.org:29418/servertools/webtools.servertools.git
#'''ssh://userid@git.eclipse.org/gitroot/ejb/webtools.ejb.git'''
+
git clone ssh://${GITUSER}@git.eclipse.org:29418/jsdt/webtools.jsdt.git
#'''ssh://userid@git.eclipse.org/gitroot/jsf/webtools.jsf.git'''
+
git clone ssh://${GITUSER}@git.eclipse.org:29418/sourceediting/webtools.sourceediting.git
#'''ssh://userid@git.eclipse.org/gitroot/jsf/webtools.jsf.docs.git'''
+
 
#'''ssh://userid@git.eclipse.org/gitroot/jsf/webtools.jsf.tests.git'''
+
git clone ssh://${GITUSER}@git.eclipse.org:29418/jeetools/webtools.javaee.git
#'''ssh://userid@git.eclipse.org/gitroot/dali/webtools.dali.git'''
+
git clone ssh://${GITUSER}@git.eclipse.org:29418/dali/webtools.dali.git
#'''ssh://userid@git.eclipse.org/gitroot/servertools/webtools.servertools.git'''
+
git clone ssh://${GITUSER}@git.eclipse.org:29418/jsf/webtools.jsf.git
#'''ssh://userid@git.eclipse.org/gitroot/servertools/webtools.servertools.devsupport.git'''
+
git clone ssh://${GITUSER}@git.eclipse.org:29418/webservices/webtools.webservices.git
#'''ssh://userid@git.eclipse.org/gitroot/servertools/webtools.servertools.docs.git'''
+
 
#'''ssh://userid@git.eclipse.org/gitroot/servertools/webtools.servertools.tests.git'''
+
git clone ssh://${GITUSER}@git.eclipse.org:29418/webtools/webtools.releng.git
#'''ssh://userid@git.eclipse.org/gitroot/webservices/webtools.webservices.git'''
+
git clone ssh://${GITUSER}@git.eclipse.org:29418/webtools/webtools.releng.aggregator.git
#'''ssh://userid@git.eclipse.org/gitroot/webservices/webtools.webservices.axis2.git'''
+
</source>
#'''ssh://userid@git.eclipse.org/gitroot/webservices/webtools.webservices.jaxws.git'''
+
 
#'''ssh://userid@git.eclipse.org:29418/jsdt/webtools.jsdt.git'''
+
 
#'''ssh://userid@git.eclipse.org/gitroot/sourceediting/webtools.sourceediting.git'''
+
Please refer to:
#'''ssh://userid@git.eclipse.org/gitroot/sourceediting/webtools.sourceediting.tests.git'''
+
 
#'''ssh://userid@git.eclipse.org/gitroot/sourceediting/webtools.sourceediting.xpath.git'''
+
* [[WTP_Git_Workflows#Clone_a_repo]] for more detailed instructions on how to clone a repository or for anonymous read-only access.
#'''ssh://userid@git.eclipse.org/gitroot/sourceeditin/webtools.sourceediting.xpath.tests.git'''
+
* [[Gerrit#Enabling_Gerrit_for_your_Eclipse.org_Project]] for how to enable Gerrit for your project.
#'''ssh://userid@git.eclipse.org/gitroot/sourceediting/webtools.sourceediting.xsl.git'''
+
#'''ssh://userid@git.eclipse.org/gitroot/sourceediting/webtools.sourceediting.xsl.tests.git'''
+
#'''ssh://userid@git.eclipse.org/gitroot/webtools/webtools.releng.git'''
+
#'''ssh://userid@git.eclipse.org/gitroot/webtools/webtools.maps.git'''
+
Please refer to the [[WTP_Git_Workflows#Clone_a_repo]] for more detailed instructions on how to clone a repository.
+
  
 
= Configure Notification =
 
= Configure Notification =
 
To be informed of the incoming review requests, you need to configure the Gerrit notification by watching the projects.
 
To be informed of the incoming review requests, you need to configure the Gerrit notification by watching the projects.
  
# Log on to [https://git.eclipse.org/r/#/settings/projects Eclipse Git repository] with your Eclipse id
+
# Log on to [https://git.eclipse.org/r/#/settings/projects Eclipse Git repository] with your Eclipse id[[File:ConfigNotification.PNG]]
# Put the interested project name,jeetools for instance, in the '''Project Name''' and select the project from the suggested project list
+
# Put the interested project name, '''jeetools''' for instance, in the '''Project Name''' field and select the project from the suggested project list
 
# Click the '''Watch''' button to add the project to the watch list
 
# Click the '''Watch''' button to add the project to the watch list
 
# Select all check boxes to get all types of notifications
 
# Select all check boxes to get all types of notifications
Line 67: Line 62:
 
For detailed instructions on WTP development procedure see [[WTP_Git_Workflows]].
 
For detailed instructions on WTP development procedure see [[WTP_Git_Workflows]].
  
[[Category:Git]][[Category:Eclipse Web Tools Platform Project| ]]
+
[[Category:Git]]
 +
[[Category:Eclipse Web Tools Platform Project]]
 +
[[Category:WTP Releng]]

Revision as of 21:48, 27 May 2018

WTP source code is managed by the Eclipse Git repositories. After Gerrit process is enabled for the repository, there are a few changes to the existing way of accessing the repositories. This page contains information on how to access the Gerrit enabled WTP repositories via EGit using SSH. It also may help to set up the access to the WTP repositories even if other UI is used.

Please refer to the WTP_Git_Workflows for more detailed instructions on WTP development procedure.

Generate the SSH2 authentication key

  1. Open the General > Network Connections > SSH2 preference page SSH2 General.PNG
  2. Check the SSH2 home directory on the General tab to see if there is already an existing key.
    1. If yes, you can continue to next step to upload the key to the Git host.
    2. If not yet, switch to the Key Management tab and click the button Generate RSA Key... to generate one.SSH2 KeyManagement.PNG
  3. Put in a passphrase in the field Passphrase and save it properly for future reference.
  4. Click Save Private Key... button to save the private key to the SSH2 home directory.
  5. Copy the public key displayed in the dialog to upload it to the host as instructed below.

You can also generate SSH key pair on command line

Upload the SSH2 public key

  1. Log on to Eclipse Git repository with your Eclipse id
  2. Click the Add Key... button to open the dialogUploadPublicKey.PNG
  3. Paste the public key copied from the Eclipse preferences page to the public key area
  4. Click the Add button to close the dialog

Clone a repository for development

With Gerrit enabled, gitroot URLs like ssh://${GITUSER}@git.eclipse.org/gitroot/jeetools/webtools.javaee.git are ready only.

Push changes to Gerrit on port 29418: ssh://${GITUSER}@git.eclipse.org:29418/jeetools/webtools.javaee.git.

Here's the complete list of current repos, as of 2017-06-15. This list is subject to change as new repos are created or existing repos are merged.

GITUSER=YOUR_ECLIPSE_GITUSER
git clone ssh://${GITUSER}@git.eclipse.org:29418/webtools-common/webtools.common.git
git clone ssh://${GITUSER}@git.eclipse.org:29418/servertools/webtools.servertools.git
git clone ssh://${GITUSER}@git.eclipse.org:29418/jsdt/webtools.jsdt.git
git clone ssh://${GITUSER}@git.eclipse.org:29418/sourceediting/webtools.sourceediting.git
 
git clone ssh://${GITUSER}@git.eclipse.org:29418/jeetools/webtools.javaee.git
git clone ssh://${GITUSER}@git.eclipse.org:29418/dali/webtools.dali.git
git clone ssh://${GITUSER}@git.eclipse.org:29418/jsf/webtools.jsf.git
git clone ssh://${GITUSER}@git.eclipse.org:29418/webservices/webtools.webservices.git
 
git clone ssh://${GITUSER}@git.eclipse.org:29418/webtools/webtools.releng.git
git clone ssh://${GITUSER}@git.eclipse.org:29418/webtools/webtools.releng.aggregator.git


Please refer to:

Configure Notification

To be informed of the incoming review requests, you need to configure the Gerrit notification by watching the projects.

  1. Log on to Eclipse Git repository with your Eclipse idConfigNotification.PNG
  2. Put the interested project name, jeetools for instance, in the Project Name field and select the project from the suggested project list
  3. Click the Watch button to add the project to the watch list
  4. Select all check boxes to get all types of notifications

References

For background reading on Git and Gerrit, see Git#Resources and Gerrit. For detailed instructions on WTP development procedure see WTP_Git_Workflows.

Back to the top