welcome: please sign in

Diff for "MemberManual/VersionControl/git"

Differences between revisions 14 and 15
Revision 14 as of 2013-01-14 09:20:36
Size: 2034
Editor: ClintonEbadi
Comment: cat / update
Revision 15 as of 2014-04-30 06:42:23
Size: 2500
Editor: ClintonEbadi
Comment: .hcoop-git will exist for almost all members, and the page needs to be rewritten to be slightly clearer
Deletions are marked like this. Additions are marked like this.
Line 13: Line 13:
First, you will want to make a {{{~/.hcoop-git}}} directory. When you do, the gitweb interface and the git daemon will pick it up automatically. You should have a directory named `~/.hcoop-git`, but if your account is old enough you may have to create it manually:
Line 19: Line 19:

The gitweb interface and the git daemon will pick it up any repositories stored the directory automatically.
Line 33: Line 35:
A better method is to mirror the repository into `~/.hcoop-git`. This should Just Work and pick up the correct permissions from the `~/.hcoop-git` ACL. You can also use this method to mirror repositories hosted elsewhere (but you'll need to manually pull, or write a cron job to do so):

{{{
git clone --mirror $PATH-TO-YOUR-PROJECT $PROJECT-NAME.git
}}}
Line 41: Line 49:
CategoryMemberManual CategoryMemberManual CategoryNeedsWork

This page describes the ways in which we use git at HCoop.

System-wide git

We have set up a gitweb repository viewer at http://git.hcoop.net/. We also have a git daemon, which can be used to quickly retrieve a project. People can host projects there simply by adding bare git repositories under their ~/.hcoop-git/ directory. This directory can be a hierarchy if you want to categorize your projects.

Getting started

You should have a directory named ~/.hcoop-git, but if your account is old enough you may have to create it manually:

mkdir ~/.hcoop-git
fsr setacl ~/.hcoop-git system:anyuser read

The gitweb interface and the git daemon will pick it up any repositories stored the directory automatically.

Making projects available

It is recommended that you put bare git repositories under ~/.hcoop-git. Bare git repositories are the .git directories within a git project. If you want to keep a (pre-existing) copy of the working directory elsewhere, then do the following. PROJECT is the name of your project. WORKDIR is the location of your working directory.

ln -s WORKDIR/.git ~/.hcoop-git/PROJECT.git
fsr setacl ~/.hcoop-git/PROJECT.git/. system:anyuser read

Note that the above command is "fsr", not "fs"!

If you forget to run this command on any subdirectories in ~/.hcoop-git, none of your projects will show up in the gitweb interface!

A better method is to mirror the repository into ~/.hcoop-git. This should Just Work and pick up the correct permissions from the ~/.hcoop-git ACL. You can also use this method to mirror repositories hosted elsewhere (but you'll need to manually pull, or write a cron job to do so):

git clone --mirror $PATH-TO-YOUR-PROJECT $PROJECT-NAME.git

Alternatively, you can copy the .git directory from elsewhere and then run the fsr setacl command mentioned above.

When you have directories of bare git projects being served by gitweb, it is the convention to name them in this fashion: that is, the name of the project, followed by ".git".

It will take up to 15 minutes for any new projects to show up on the web interface, because we cache the front page.

To change the description displayed on the web interface for the project, edit the file ~/.hcoop-git/PROJECT.git/description.


CategoryMemberManual CategoryNeedsWork

MemberManual/VersionControl/git (last edited 2014-04-30 06:42:47 by ClintonEbadi)