nitrc:User Guide - Git Administration
From NITRC Wiki
 |  |
NITRC supports git for source control management. Repositories may be set up, accessed, and maintained using ssh to NITRC; currently there is no NITRC web interface for git.
For assistance using git on NITRC, please contact moderator@nitrc.org.
Setting Up Git on NITRC
At tool/resource registration, select either CVS or SVN; git support is independent of the current integrated SCM mechanisms.
Once you have registered your tool/resource, you as the primary administrator may set up one or more git repositories on NITRC. Access is controlled using UNIX user and group permissions on the NITRC server; NITRC users are UNIX users, and your tool/resource unixname is the UNIX group to which your tool/resource members belong.
| Note: NITRC's underlying system permissions as described here are updated hourly to reflect changes made on NITRC. When adding a user to a NITRC tool/resource, please allow an hour for access permissions to propagate to your git repository. |
| Note: Changing SCM user permissions in the NITRC tool/resource Admin pages will not affect git permissions. |
To set up an empty git repository, create the repository and alter group ownership and permissions:
ssh user@www.nitrc.org git --bare init /home/groups/unixname/git
ssh user@www.nitrc.org chgrp -R unixname /home/groups/unixname/git
ssh user@www.nitrc.org chmod -R g+rwxs /home/groups/unixname/git
The last command grants all tool/resource members read/write access to the repository. Read access to the repository may be granted to other NITRC users using:
ssh user@www.nitrc.org chmod -R o+rx /home/groups/unixname/git
The NITRC git repository may then be accessed using ssh as the URL protocol. For instance, to commit a local git project to the NITRC git repository, use:
git push ssh://user@www.nitrc.org/home/groups/unixname/git master
To check out a NITRC git repository:
git clone ssh://user@www.nitrc.org/home/groups/unixname/git
Integration with your NITRC Tool/Resource
Although NITRC's git support is currently not integrated with the web interface, we recommend the following changes to your NITRC tool/resource to reflect the use of git.
Your tool/resource was set up with a CVS or SVN repository, so this should be disabled. Follow the "Edit Public Info" link in your tool/resource's administration pages and turn off "Use Source Code Repository (SCM)."
If you wish to let tool/resource members or users know about your git repository, we recommend creating a wiki page or custom web page describing access to the repository and pointing a custom tool menu entry to this page. (This will take the place of the standard Source Code link that you just removed.)
