aboutsummaryrefslogtreecommitdiff
path: root/README.adoc
blob: 5dad41735bf7affc306f67ad570c2eceda53c283 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
= gitolite-admin

Configuration files used for https://gitolite.com/gitolite/index.html[gitolite], the daemon which
manages access controls, git-daemon, and SSH-accessible git repositories.

== Gitolite configuration details

=== Hooks and triggers

----
local
├── hooks
│   └── repo-specific               - All hooks are controlled by the 'repo-specific-hooks' plugin
│       │                             on gitolite, because that simplifies mixing and matching hooks
│       │                             as needed.
│       ├── cgit-agefile            - cgit can use an "agefile" to track the idle time of a
│       │                             repository more accurately. This simply touches that file when
│       │                             a push to a repository is received.
│       ├── deploy-laminar-config   - This hook is used for the laminar-admin repository, to copy
│       │                             the configuration files to the right place on the server.
│       ├── irccat                  - This hook is used to output commits to IRC channels.
│       └── push-to-mirror          - This hook is used to push to mirror of local repositories.
│                                     Some repositories on git.mutiny.red are mirrored to GitHub,
│                                     namely all the mutiny/* repositories and a few of my (somasis)
│                                     personal repositories.
└── triggers
    └── POST_GIT
        └── fix_default_branch.sh   - When possible, I use "main" for all my git repositories.
                                      Gitolite doesn't correctly set the symbolic-ref for HEAD when
                                      a repository is pushed to for the first time though, and so
                                      if left unfixed, it won't be cloned properly. This fixes that.
----

== cgit

This repository *also* contains the configuration files for https://git.zx2c4.com/cgit[cgit], so as
to simplify deployment. Since cgit and gitolite interact so heavily, it seems easier just to put the
configuration files next to each other.