Table of Contents |
---|
Introduction
Gitolite is an access control layer on top of git. Here are the features that most people see:
- Use a single unix user ("real" user) on the server.
- Provide access to many gitolite users:
- they are not "real" users,
- they do not get shell access.
- Control access to many git repositories:
- read access controlled at the repo level,
- write access controlled at the branch/tag/file/directory level, including who can rewind, create, and delete branches/tags.
- Can be installed without root access, assuming git and perl are already installed.
- Authentication is most commonly done using sshd, but you can also use http if you prefer (this may require root access).
Pre-requisites
Server
- Any Unix system with a posix POSIX compatible "sh" and a sane file system.
- Git version 1.6.6 or later. (Git 1.7.8 or later if you want to run the test suite).
- Perl 5.8.8 or later.
- Openssh (almost any version). Optional if you're using smart http.
- A dedicated Unix userid to be user for the hosting user, usually "git" but it can be any user, even your own normal one. (If you're using an RPM/DEB the install probably created one called "gitolite").
...
TODO: which packages to install for Ubuntu 12.04 and 14.04 and Debian 6, 7 and 8?
Client
- Openssh client.
- Git 1.6.6 or later. Almost any git client will work, as long as it knows how to use ssh keys and send the right one along.
TODO: which packages to install for Ubuntu 12.04 and 14.04 and Debian 6, 7 and 8?
The gitolite client is an ordinary git client, documented at Git user manual
Installation
Server
Gitolite has only one server side "command" now, much like git itself. This command is gitolite
. You don't need to place it anywhere special; worst case you run it with the full path.
...
When in doubt, run 'gitolite setup' anyway; it doesn't do any harm, though it may take a minute or so if you have more than a few thousand repos!
Client
TBCThe gitolite client is an ordinary git client, documented at Git user manual
Configuration and administration
Gitolite
to adminster gitolite just
...
Code Block |
---|
git commit -a #tell git about the changes you want to incorporate git push # send it to the server |
Client
...
the |
...
In case the file does not already exist, create it with bluelight git's /"conf/ssh/Individual user/config.head":
Code Block | ||
---|---|---|
| ||
# User-specific ssh client configuration # Documentation: ssh_config man page # Default values (may be explicitly listed below for visibility): # - Protocol 2 (important; many options are protcol-specific) # - ServerAliveCountMax 3 Host * Compression yes Protocol 2 SendEnv LANG LC_* ServerAliveInterval 15 ServerAliveCountMax 3 |
...
server |
...
Code Block | |
---|---|
title | ~.ssh/config|
Host git
HostName git.bluelightav.org
Port 2222
User git
|
References
Documentation
...
References
TBC