Eclipse and Github Tutorial

Max Rohde

May 25, 2012 — 6 min read

Github is an awesome repository to share your source code. Although there are numerous tutorials discussing how to use git and eclipse, I got stuck again today while trying to upload an existing eclipse project to github. This tutorial walks thus through all the steps from signing up for github to uploading an eclipse project to the site!

Please note that the focus of this tutorial is the mere upload of source code and not any of the more sophisticated features git and github offer.

The following steps will be discussed in this tutorial:

Sign Up for github
Installing EGit
Create a DSA Key in Eclipse
Register DSA Key with github
Create Repository on github
Import github Repository into eclipse
Link Eclipse Project with github Repository
Uploading Project Sources to github

That's the easiest part, just go to https://github.com/ and register!

Step 2: Installing EGit

You will need to install the git plugin for eclipse, EGit, in order to upload code from eclipse projects.

In eclipse, go to Help / Install New Software

Open the eclipse Indigo repository

Select Collaboration / Eclipse EGit

Click [Next]
JGit should have been selected for you automatically

Click [Next] and confirm the licence agreement
Restart eclipse and the EGit plugin should be installed

Step 3: Create a DSA Key in Eclipse

In order to be able to upload source code to github, you need to define a secure key, which must be known both to your local eclipse installation as well as the github service. Luckily, eclipse provides all the tooling necessary to generate the appropriate key.

Open Menu Window / Preferences
In the preferences, go to General / Network Connections / SSH2
On the SSH2 page, open the tab 'Key Management'

Click on [Generate DSA Key …]
At the bottom of the page, enter a passphrase of your choosing

Click [Save Private Key …] (what's going on with these three dots in the button captions … strange)
Save the key at a location of your choosing (best in the location specified as your SSH2 home on under the tab General)

Step 4: Register DSA Key with github

Open the file you have saved in the previous step with a text editor (e.g. Notepad on windows)
Select the contents of the file (Ctrl + A) and copy the complete text
Go to the github website (https://github.com) and login
On the top right of the screen, click on 'Account Settings'

On the left hand side of the account settings, click on 'SSH Keys'

Click on [Add SSH key]
Provide an appropriate title for your key (e.g. 'EGit 1' ?)
Paste the contents from the text file containing your DSA key into the text box 'Key'

Click [Add Key] at the bottom of the form

Step 5: Create Repository on github

In order to upload source code from a project in eclipse to github, you will need to create a github repository.

Go to github homepage (https://github.com/) and log in
At the top right corner, click on 'Create a New Repo'

Chose a repository name and description to your liking and click [Create Repository]

Step 6: Import github Repository into eclipse

Before you can link an existing eclipse project to a github repository, you must import the repository you have created on github first. For this:

In eclipse, open Menu / Window / Show View / Other …

Select Git / Git Repositories and click [Ok]

You might see a warning message such as the one show below (even setting the environment variable did not help me to get rid of the message, but everything seems to be working okay) – you can confirm with [Ok]

You should have a new view 'Git Repositories now'
Click on 'Clone a Git repository' within the new view

Now go back to https://github.com and to your newly created github repository
Under your repository description, you can get the URI for your project. Copy the text starting with 'git@' (make sure that SSH is selected)

Go back to eclipse. You can paste the URI you have just copied into the field 'URI'
Further select as Protocol 'ssh'
Click [Finish]

If asked to select a branch, select the 'master' branch

Git (in difference to subversion) allows storing a full blown repository on your local machine rather than just a local copy of the files. This requires to store all source you want to synchronize with git at least twice on your local machine: one copy will be stored in the clone of the remote git repository and another one will be stored in your eclipse project.

Hence, when you close the git repository from github, you should define a repository location, which lies outside the eclipse project you want to upload:

Select one such location and click [Finish]

Now you should have one 'Git Repository'

Step 7: Link Eclipse Project with github Repository

After you have created a local clone of the repository from github, you can link the eclipse project you would like to upload to this local repository.

Right click your eclipse project and select Team / Share Project …
Select 'Git' as Repository Type

Select under 'Repository' the repository you have cloned in the previous step and click [Finish]

Step 8: Uploading Project Sources to github

After you have linked your project with the local clone of the github repository, you can 'Commit' all the source files in your existing project to this repository. After you have committed the files to your local repository, you can 'Push' them to the github repository.