Jump to: navigation, search

WTP Gerrit Access

Revision as of 14:20, 1 June 2017 by Kchong.ca.ibm.com (Talk | contribs) (Clone a repository for development)

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

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.

Please use the following URLs to access the repositories to push the change set.

  1. ssh://userid@git.eclipse.org/gitroot/webtools-common/webtools.common.git
  2. ssh://userid@git.eclipse.org/gitroot/webtools-common/webtools.common.fproj.git
  3. ssh://userid@git.eclipse.org/gitroot/webtools-common/webtools.common.snippets.git
  4. ssh://userid@git.eclipse.org/gitroot/webtools-common/webtools.common.tests.git
  5. ssh://userid@git.eclipse.org:29418/jeetools/webtools.javaee.git
  6. ssh://userid@git.eclipse.org:29418/jeetools/webtools.javaee.tests.git
  7. ssh://userid@git.eclipse.org/gitroot/ejb/webtools.ejb.git
  8. ssh://userid@git.eclipse.org:29418/jsf/webtools.jsf
  9. ssh://userid@git.eclipse.org:29418/jsf/webtools.jsf.docs
  10. ssh://userid@git.eclipse.org:29418/jsf/webtools.jsf.tests
  11. ssh://userid@git.eclipse.org/gitroot/dali/webtools.dali.git
  12. ssh://userid@git.eclipse.org:29418/servertools/webtools.servertools.git
  13. ssh://userid@git.eclipse.org:29418/servertools/webtools.servertools.devsupport.git
  14. ssh://userid@git.eclipse.org:29418/servertools/webtools.servertools.docs.git
  15. ssh://userid@git.eclipse.org:29418/servertools/webtools.servertools.tests.git
  16. ssh://userid@git.eclipse.org:29418/webservices/webtools.webservices.git
  17. ssh://userid@git.eclipse.org:29418/webservices/webtools.webservices.axis2.git
  18. ssh://userid@git.eclipse.org:29418/webservices/webtools.webservices.jaxws.git
  19. ssh://userid@git.eclipse.org:29418/jsdt/webtools.jsdt.git
  20. ssh://userid@git.eclipse.org:29418/sourceediting/webtools.sourceediting.git
  21. ssh://userid@git.eclipse.org:29418/sourceediting/webtools.sourceediting.tests.git
  22. ssh://userid@git.eclipse.org:29418/sourceediting/webtools.sourceediting.xpath.git
  23. ssh://userid@git.eclipse.org:29418/sourceeditin/webtools.sourceediting.xpath.tests.git
  24. ssh://userid@git.eclipse.org:29418/sourceediting/webtools.sourceediting.xsl.git
  25. ssh://userid@git.eclipse.org:29418/sourceediting/webtools.sourceediting.xsl.tests.git
  26. ssh://userid@git.eclipse.org/gitroot/webtools/webtools.releng.git
  27. 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

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.