Difference between revisions of "Orion/How Tos/Cloning repository from github"

From Eclipsepedia

< Orion‎ | How Tos
Jump to: navigation, search
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
You have an account on GitHub and want use Orion to contribute to a GitHub repository?
+
Say you have an account on [http://github.com GitHub], and want use Orion to contribute to work on code in your GitHub repository. Read on for details on how to configure Orion to work with your GitHub repository.
  
 
= Cloning a Git repository hosted on GitHub  =
 
= Cloning a Git repository hosted on GitHub  =
  
#Obtain a repository URI. Go to GitHub repository home page and copy the repository URI, typically '''SSH''' and '''HTTP''' give read and write access and '''Git''' protocol gives you read-only access.<br>[[Image:GithubURI.PNG]]<br><br>  
+
#Obtain a repository URI. Go to the GitHub repository home page and copy the repository URI.<br>Typically '''SSH''' and '''HTTP''' give read and write access and '''Git''' protocol gives you read-only access.<br>[[Image:GithubURI.PNG|A github repository's URI edit field with the ssh radio selected]]<br><br>  
#If you are using a secure connection you might be required to configure your public key. On GitHub go to '''Account Settings -&gt; SSH Public Keys''' and choose '''Add another public key'''<br>[[Image:GithubAddPublicKey.PNG]]<br><br>
+
#If you are using a secure connection you might be required to [https://help.github.com/articles/generating-ssh-keys configure your public key].
#Copy contents of your public key file in the '''Key''' field. Typically you can find your public/private keys in '''.ssh''' directory in your home directory on your file system
+
#Login to [http://orion.eclipse.org/ Orion] and go to the '''Repositories link'''.<br>[[Image:Orion Repostories link.png|Repositories link in the nav bar of an Orion page]]<br><br>  
#Confirm adding public key by selecting '''Add key''' button
+
#Choose the '''Clone Repository''' button and copy your Git repository URI into the Repository URL input.<br>[[Image:Clone git repository dialog.png|Clone git repository dialog]]<br><br>  
#Login to Orion and go to '''Repositories link'''<br>[[Image:Orion Repostories link.png]]<br><br>  
+
# You will be prompted for credentials.<br>[[Image:orion_credentials.png|Orion credentials prompt]]<br>
#Choose '''Clone''' button and copy the your Git repository URI into the Repository URL input<br>[[Image:Clone git repository dialog.png]]<br><br>  
+
##If you added the public key to github, then you need to copy the contents of your private key file (typically in your '''.ssh''' directory underneath your home directory in your local file system) into the '''Private key:''' field.  If your key defined a passphrase, supply it also.
#If you are using secure protocol input your credentials<br>'''Ssh username''' - username (optional if you are authenticating via private key)<br>'''Ssh password''' - password (optional if you are authenticating via private key)<br>'''Private key''' - private key (optional if you are authenticating via user/password) to match the public key uploaded on GitHub. Typically you can find your public/private keys in '''.ssh''' directory in your home directory on your file system, please copy the contents of the private key file with any whitespace it contains<br>'''Passphrase''' - passphrase if required by your private key<br>
+
##If you are using ssh login, input your credentials<br>'''Ssh username''' - username <br>'''Ssh password''' - password <br>
#Confirm credentials and wait until your repository is cloned
+
#Confirm your credentials and wait until your repository is cloned.
  
For more information about Orion git client go to [[Orion/How Tos/Working with git]]
+
For more information about using Git with Orion, see the [[Orion/Documentation/User_Guide|Orion User Guide]].

Revision as of 16:20, 25 January 2013

Say you have an account on GitHub, and want use Orion to contribute to work on code in your GitHub repository. Read on for details on how to configure Orion to work with your GitHub repository.

Cloning a Git repository hosted on GitHub

  1. Obtain a repository URI. Go to the GitHub repository home page and copy the repository URI.
    Typically SSH and HTTP give read and write access and Git protocol gives you read-only access.
    A github repository's URI edit field with the ssh radio selected

  2. If you are using a secure connection you might be required to configure your public key.
  3. Login to Orion and go to the Repositories link.
    Repositories link in the nav bar of an Orion page

  4. Choose the Clone Repository button and copy your Git repository URI into the Repository URL input.
    Clone git repository dialog

  5. You will be prompted for credentials.
    Orion credentials prompt
    1. If you added the public key to github, then you need to copy the contents of your private key file (typically in your .ssh directory underneath your home directory in your local file system) into the Private key: field. If your key defined a passphrase, supply it also.
    2. If you are using ssh login, input your credentials
      Ssh username - username
      Ssh password - password
  6. Confirm your credentials and wait until your repository is cloned.

For more information about using Git with Orion, see the Orion User Guide.