doc warnings:

doc/admin: add warning about creating repos manually!
doc/4: add warning on compile errors when using p-t-a
This commit is contained in:
Sitaram Chamarty 2009-09-16 10:16:11 +05:30 committed by Sitaram Chamarty
parent 7d0e778bad
commit 780f636c0a
2 changed files with 27 additions and 3 deletions

View file

@ -5,6 +5,14 @@
### administer ### administer
First of all, ***do NOT add new repos manually***, unless you know how to add
the required hook as well. Without the hook, branch-level access control will
not work for that repo, which sorta defeats the idea of using gitolite :-)
Please read on to see how to do this correctly.
#### adding users and repos
* ask each user who will get access to send you a public key. See other * ask each user who will get access to send you a public key. See other
sources (for example sources (for example
[here](http://sitaramc.github.com/0-installing/2-access-gitolite.html#generating_a_public_key)) [here](http://sitaramc.github.com/0-installing/2-access-gitolite.html#generating_a_public_key))
@ -16,9 +24,15 @@
* copy all these `*.pub` files to `$GL_KEYDIR` * copy all these `*.pub` files to `$GL_KEYDIR`
* edit the config file (`$GL_CONF`) and give the new users permissions as * the config file (`$GL_CONF`) is very well commented, please take a couple
required. The users names should be exactly the same as their keyfile of minutes to read it. Then edit it and
names, but without the `.pub` extension
* add new repos as needed
* add new users and give them permissions as required. The users names
should be exactly the same as their keyfile names, but without the
`.pub` extension
#### compiling
* backup your `~/.ssh/authorized_keys` file if you feel nervous :-) * backup your `~/.ssh/authorized_keys` file if you feel nervous :-)
* that's "backup" as in "copy", not "move". The next step won't work if * that's "backup" as in "copy", not "move". The next step won't work if

View file

@ -22,6 +22,16 @@ The instructions are presented as shell commands; they should be fairly
obvious. All paths are from the default `~/.gitolite.rc`; if you changed any, obvious. All paths are from the default `~/.gitolite.rc`; if you changed any,
make the same changes below. make the same changes below.
> ----
> **WARNING**: the "compilation" runs via a `post-update` hook. Which, by
> definition, runs *after* the push has successfully completed. As a
> result, a *compilation error* will be visible to the admin doing the `git
> push` but will not otherwise look like an error to client-side git (in
> terms of return codes, scripting, etc., or even the "git gui" if you
> happen to use that for pushing). So be sure to watch out for compile
> error messages on push when you do this.
---- ----
First, on the server, log on to the `git` userid, add a new repo called First, on the server, log on to the `git` userid, add a new repo called