non-core programs shipped with gitolite


[[TOC]]


commands

A list of these commands can be obtained by running gitolite help on the server. A different (and probably much smaller) list can be obtained by a remote user running ssh git@host help.

All the commands that ship with gitolite will respond to -h; please report a bug to me if they don't.

Here's a list of remote commands that are shipped:

syntactic sugar

The following "sugar" programs are available:

triggers

The PRE_GIT triggers are:

The POST_GIT triggers are:

The POST_COMPILE triggers are:

The POST_CREATE triggers are:

VREFs

VREFs have their [own page][vref].

special cases

#partial-copy partial-copy: selective read control for branches

Git (and therefore gitolite) cannot do selective read control -- allowing someone to read branch A but not branch B. It's the entire repo or nothing.

[Side note: Gerrit Code Review can do that, but that is because they have their own git stack (and their own sshd, and so on) all in one big Java program. Gerrit is really useful if you want code review to be part of the access control decision]

Gitolite can now help you do this. Note that this is only for branches; you can't do this for files and directories.

Here's how:

  1. enable 'partial-copy' in the PRE_GIT section in the rc file.

  2. for each repo "foo" which has secret branches that a certain set of developers (we'll use a group called @temp-emp as an example) are not supposed to see, do this:

    repo foo
        # rules should allow @temp-emp NO ACCESS
    
    
    repo foo-partialcopy-1
        -   secret-branch               =   @temp-emp
        # other rules should ensure ONLY @temp-emp has ANY ACCESS
        # NO other user should have access
    
    
    
    -   VREF/partial-copy           =   @all
    config gitolite.partialCopyOf   =   foo
    

    IMPORTANT: if you're using other VREFs, please make sure this one is placed at the end, after all the others.

And that should be it. Please test it and let me know if it doesn't work!

WARNINGS: