nitrc:User Guide - Tool/Resource Feature: Source Code

From NITRC Wiki

Users: Getting Started | Browse | Search | Compare | Upload/Download | Personalize | Features

Administrators: Getting Started | Registration | Administration | Other Features

Developers may choose to manage their tool/resource source code on NITRC. The source code management tool (either CVS or SVN) was selected by the administrator when the tool/resource was registered. Clicking the tool/resource menu "Source Code" link shows a page that contains information on accessing the source code management (SCM) repository.

Accessing the Source Code

Developer access information is provided on the main SCM - Source Code Repository page. If the administrator has enabled anonymous public read access, anonymous access information is also provided. Use this information to configure your client for CVS or SVN access.

Installing SSH Keys for CVS Access

To avoid having to type your password every time for your CVS/SSH developer account, you may upload your public key(s). Public SSH keys need to be placed in a text file in your home directory: ~/.ssh/authorized_keys. In addition, for security, the .ssh directory and authorized_keys file must have group and other permissions cleared. For your command-line SFTP client, please follow these instructions.

1. Make public/private keys according to the instructions of your CVS/SSH client.
2. Locally, create a text file name "authorized_keys" that contains the public key. If you need access to your account with more than one key, then put each key on a separate line in the file.
3. Using your NITRC account and SFTP client, connect to www.nitrc.org.
4. Create a ".ssh" directory with the correct permissions (user-only: read, write, and navigate) using the following commands:
   1. mkdir .ssh
   2. chmod 700 .ssh
5. Switch to your new .ssh directory:
   1. cd .ssh
6. Upload the authorized_keys file you created in step 2, and change the permissions (user-only: read and write):
   1. chmod 600 authorized_keys

Now, you should be set up to use you CVS/SSH developer account without having to enter your password every time.

Downloading Source Code Tree

If public read access has been granted, you may download a compressed file of all the files in the repository by clicking "Download The Nightly CVS Tree Snapshot" or "Download The Nightly SVN Tree Snapshot."

Browsing Source Code Repository

In the Repository History section, the number adds and commits/updates are shown for the selected tool/resource. These counts are updated nightly, so you will not see an immediate increase in these counts as files are added and committed/updated. The "Browse CVS Repository" link or "Browse Subversion Repository" link is shown if public read access has been granted. Clicking this link opens the SCM Web interface, where you can view the repository, view differences between revisions, and download versions of a file.