Setting Up Github

From sdk-wiki
Revision as of 15:26, 29 July 2014 by Sdkuser (talk | contribs) (Changed protection level for "Setting Up Github": Setting Permissions for (almost all) Pages - editable and moveable by all logged in users ([Edit=Allow only autoconfirmed users] (indefinite) [Move=Allow only autoconfirmed users] (indefinite)))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Description

This tutorial describes Github setup/configuration allowing for access to the private Rethink SDK repositories

Step 1: Submit Github Credentials

In order to access private Rethink SDK repositories, access must be granted to your account. This available to current Baxter Research Robot customers.


If you do not already have a Github account please create one at https://www.github.com.


Please email Research SDK support at rsdk.support@rethinkrobotics.com with your github username, PO/order number, and serial number of your robot. We will get back to you shortly with full access to the Wiki, which will explain how to set up the Research SDK with your Baxter.

Step 2: Configure Necessary Git Settings

Your local git configuration will be compared to and validated with your Github credentials.

Verify git installation:

$ sudo apt-get install git-core


Set up your git credentials on the development workstation as follows.

# Export Git global username
$ git config --global user.name "<FirstName LastName>"

# Export Git global email
$ git config --global user.email <user@company.com></code>

Step 3: Generate SSH Keys and Upload to Github

This step has been well documented by Github. We highly recommend following the Github SSH Key Generation and Upload Instructions

The Gist:

  • Github will need your SSH public* (.pub) key.
  • Navigate to your ~/.ssh directory and copy the full contents of the id_dsa.pub file to the clipboard.
    • If there is no id_dsa.pub file in this folder, run: $ ssh-keygen -t dsa to create one.
    • Simply hit enter when prompted without typing anything to create the files in the correct location.
  • Now go to Github.com and log in with the Github account you will use with Rethink Software.
  • Go to Account settings (2nd icon right of your account name, on the top navigation bar of Github.com).
  • Navigate to the left panel, and click "SSH Keys".
  • Now click the "Add SSH key" button in the upper right of the SSH Keys page.
  • Enter a name for the key and paste the contents of your clipboard into the "Key" section, then save the key.