aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--README45
1 files changed, 45 insertions, 0 deletions
diff --git a/README b/README
index 1b97967..5d2115b 100644
--- a/README
+++ b/README
@@ -1,2 +1,47 @@
mgagit is a tool used to manage Mageia git repositories.
+How it works
+------------
+
+mgagit takes :
+ - an ldap directory containing groups, and users with ssh keys
+ - repositories definitions
+
+And generate the corresponding gitolite configuration and keys directory.
+
+
+Available commands
+------------------
+
+- glconf : Print gitolite configuration
+- glrun : Update gitolite configuration
+
+
+Configuration
+-------------
+
+Configuration is done in the file /etc/mgagit.conf. The default
+configuration is available in file /usr/share/mgagit/config.
+
+The files are in YAML format.
+
+The following configuration options are available :
+ use_ldap: enable use of ldap to fetch user keys and groups
+ ldapserver: hostname of the ldap server
+ binddn: dn used to authenticate on the ldap server
+ bindpwfile: file containing the password used to authenticate
+ groupbase: the base used to search ldap groups
+ groupfilter: filter to search ldap groups
+ userbase: the base used to search ldap users
+ userfilter: filter to search ldap users
+ uid_username_re: regular expression to extract a username from ldap uid
+ group_re: regular expression to extract group name from cn
+ pubkey_dir: directory containing users ssh keys, used by gitolite
+ tmpl_dir: templates directory
+ gitolite_config: gitolite configuration file
+ repos_config: list of repos definition directories. Use something like
+ this to include a directory containing repos definitions :
+ - prefix: prefix in the repos tree
+ include_dir: path to the directory containing definitions
+ gl_template: template file used to define the repos
+