Difference between revisions of "GitHub Connector"

From Gcube Wiki
Jump to: navigation, search
Line 10: Line 10:
 
== Select Credential ==
 
== Select Credential ==
 
:When the wizard start, you have to enter your GitHub credentials. The types of access are: Anonymous, Login and OAuth2.
 
:When the wizard start, you have to enter your GitHub credentials. The types of access are: Anonymous, Login and OAuth2.
:Note that in case of large projects only OAuth2 supports downloading of the entire project, and in any case this is the preferred way.
+
:Note that in case of large projects only OAuth2 supports downloading the entire project, and this is generally the preferred way.
  
 
[[Image:GitHubConnector_Credential_Login.png|thumb|center|800px|GitHub Connector, Credential Basic]]
 
[[Image:GitHubConnector_Credential_Login.png|thumb|center|800px|GitHub Connector, Credential Basic]]
Line 23: Line 23:
  
 
:If you want to generate a token, the steps to follow are:
 
:If you want to generate a token, the steps to follow are:
# You register and sign in on GitHub web site
+
# Register and sign in on GitHub web site
# Go in Settings
+
# Go into Settings
 
# Generate a Token
 
# Generate a Token
  
Line 36: Line 36:
 
[[Image:GitHubConnector_Repository_Selection.png|thumb|center|800px|GitHub Connector, Repository Selection]]
 
[[Image:GitHubConnector_Repository_Selection.png|thumb|center|800px|GitHub Connector, Repository Selection]]
  
:By clicking on Finish the repository content will be downloaded to the required folder.
+
:By clicking on Finish, the repository content will be downloaded to the required folder.
  
 
== Who uses GitHub Connector ==
 
== Who uses GitHub Connector ==

Revision as of 14:28, 28 July 2016

In this guide we describe the GitHub Connector wizard web interface.

Overview

GitHub Connector is a wizard to import GitHub project in a specific folder in the user workspace.

Select Credential

When the wizard start, you have to enter your GitHub credentials. The types of access are: Anonymous, Login and OAuth2.
Note that in case of large projects only OAuth2 supports downloading the entire project, and this is generally the preferred way.
GitHub Connector, Credential Basic
To access using Login or OAuth2 you must have a GitHub account. In the GitHub website you can create one
GitHub Connector, GitHub Create Accounting
In the case of OAuth2 you must have a token
GitHub Connector, Credential OAuth2
If you want to generate a token, the steps to follow are:
  1. Register and sign in on GitHub web site
  2. Go into Settings
  3. Generate a Token
GitHub Connector, GitHub Settings
GitHub Connector, GitHub Generate Token

Select Repository

After entering the credentials, you have to choose the owner and the name of the repository that you want to download.
GitHub Connector, Repository Selection
By clicking on Finish, the repository content will be downloaded to the required folder.

Who uses GitHub Connector