Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Git
Contents
- 1 List of Git repositories available
- 2 Committers new to Git
- 3 Git or Gerrit?
- 4 Your Git identity at eclipse.org
- 5 Connecting, cloning a repo
- 6 Committing and pushing
- 7 IP process implications of DVCS
- 8 Creating a new repository
- 9 Permanently deleting code from Git
- 10 Setting up ssh keys
- 11 Referencing git repositories on the wiki
- 12 You don't need Git to get code from repository
- 13 Gerrit Code Review
- 14 Errors in Cloning
- 15 Resources
- 16 Recommended Practices
List of Git repositories available
Please see http://git.eclipse.org/.
Committers new to Git
Before working on a Git repository, please:
- Read Git for Dummies
- Read The Git Parable
- Have the Git Guide handy
- Also, check out EGit
- Consider editing your Eclipse project website using Orion
Consider editing your Eclipse project website using OrionHub- Note that anyone can commit to their repo, but only Eclipse committers can push their repo to git.eclipse.org
- DON'T FORGET to configure your git environment. The 'commit' record must contain either your Eclipse User ID, or the email address registered with the Eclipse Foundation.
git config --global user.email my_committer_email@address.com git config --global user.name "John Doe"
- Note that the above will set this as the default user name and email address to use when writing commits. You can set user.name and password on a per repository basis.
git config user.email my_committer_email@address.com git config user.name "John Doe"
This will set the username and email address on just the current git repository.
Git or Gerrit?
All new repositories at Eclipse.org now use Gerrit for access, even if the project does not make use of its code review features. Some mature projects are still using Git. To find out what the project uses, please ask the project, or find the repository on http://git.eclipse.org/c/
When looking at the repositories, those using the Gerrit Code Review tool are identified as such. Please see Gerrit for more on Gerrit Code Review.
Your Git identity at eclipse.org
Your correct Git committer_id identity is at eclipse.org can be found on the Gerrit settings page. Your user ID is the same for SSH Git and Gerrit.
Note that it is NOT the same as your wiki.eclipse.org Username (which is essentially your email address), or bugs.eclipse.org Email Address.
Your Git password is your Eclipse.org site account password as set on https://dev.eclipse.org/site_login/myaccount.php.
Gerrit maintains its own password for https: https://git.eclipse.org/r/#/settings/http-password. Gerrit also maintains its own SSH keys: https://git.eclipse.org/r/#/settings/ssh-keys These passwords and keys are only used for Gerrit and are not interchangeable with the eclipse.org credentials. Gerrit over SSH does not permit password authentication. A public key must be uploaded for Gerrit over SSH.
If your firewall blocks SSH (port 22) and Gerrit SSH (29418) please try the https:// URLs provided by Gerrit.
Connecting, cloning a repo
Please see the list of Git repositories (above).
Committer access:
git clone ssh://committer_id@git.eclipse.org:29418/project/repo git clone https://committer_id@git.eclipse.org/r/a/project/repo
These services are provided via Gerrit.
Anonymous, read-only access:
git clone git://git.eclipse.org/r/project/repo git clone http://git.eclipse.org/r/project/repo
