welcome: please sign in

Diff for "MemberManual/VersionControl/git"

Differences between revisions 4 and 13 (spanning 9 versions)
Revision 4 as of 2008-01-22 02:12:13
Size: 1823
Editor: MichaelOlson
Comment: Explain how to change description
Revision 13 as of 2009-04-03 16:00:31
Size: 2213
Editor: MichaelOlson
Comment:
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
[[TableOfContents]] <<TableOfContents>>
Line 13: Line 13:
We have set up a gitweb repository 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 repositories under their {{{~/.hcoop-git/}}} directory. This directory can be a hierarchy if you want to categorize your projects. 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.
Line 26: Line 26:
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 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. 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.
Line 30: Line 30:
fsr setacl ~/.hcoop-git/PROJECT.git system:anyuser read fsr setacl ~/.hcoop-git/PROJECT.git/. system:anyuser read
Line 32: Line 32:

'''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!'''

Alternatively, you can copy the {{{.git}}} directory from elsewhere and then run the {{{fsr setacl}}} command mentioned above.
Line 35: Line 41:
'''Be sure to execute the fsr line, otherwise it will mess up the web interface!''' It will take up to 15 minutes for any new projects to show up on the web interface, because we cache the front page.

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

git packages

We try to keep up-to-date on the latest git releases, so that you don't have to compile your own binaries for git. The packages are stored at /afs/hcoop.net/common/debian/git/.

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

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.

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

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!

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.

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