Changes between Version 3 and Version 4 of TracGitosisPlugin

Timestamp:

Jul 20, 2010, 10:51:26 AM (14 years ago)

Author:

Christophe Drevet

Comment:

configuration example begin

TracGitosisPlugin

@@ -5 +5 @@
 == Description ==
 
-With this plugin, you can partially delegate gitosis administration to Trac.
+This plugin allows partial gitosis administration from Trac.
 
+Users will be able to add their public SSH key in gitosis (new settings tab).
+
+Admins will be able to set the location of the gitosis-admin repository and settings for the git repository associated with Trac (requires GitPlugin.)
 
 == Bugs/Feature Requests == 
@@ -24 +27 @@
 You can check out TracGitosisPlugin using {{{git clone git://github.com/dr4Ke/TracGitosisPlugin.git}}}, or [http://github.com/dr4Ke/TracGitosisPlugin browse the source] on !GitHub.
 
-== Example ==
+== Configuration ==
 
-Users will be able to add their public SSH key in gitosis (new settings tab).
+Before this plugin can work, you need a few things :
+ - a working git installation on the server running Trac
+ - SSH key pair without passphrase for the user running Trac
+ - access to a gitosis-admin repository
 
-Admins will be able to set the location of the gitosis-admin repository and settings for the git repository associated with Trac (requires GitPlugin.)
+=== SSH key pair ===
+Example on a RHEL server using Apache httpd :
+{{{
+# Create the key pair without passphrase
+mkdir /var/www/.ssh
+ssh-keygen -f /var/www/.ssh/id_rsa
+# Connect to the server hosting gitosis once to validate the server identity
+ssh -i /var/www/.ssh/id_rsa -o UserKnownHostsFile=/var/www/.ssh/known_hosts <git_user>@<git_server>
+# Give this directory to the user running Trac (here: apache)
+chown -Rh apache.apache /var/www/.ssh
+}}}
 
 == Recent Changes ==