Project

General

Profile

PluginGitosis » History » Version 5

Silviu Paragina, 2010-04-22 18:39

1 1 Jan from Planio www.plan.io
h1. Gitosis Plugin
2
3
A Redmine plugin which manages your gitosis configuration based on your projects and memberships in Redmine. Includes Public Key management views (extracted from "Planio":http://plan.io). 
4
5
h2. Features
6
7
* Updates your Gitosis config (create repos, add keys, add access privileges)
8
* Allows users to upload public keys
9
10
h2. Getting the plugin
11
12
Please head over to "GitHub":http://github.com/rocket-rentals/redmine-gitosis to fetch the latest version.
13
14
h2. Release notes
15
16
This plugin is provided as is and experimental. It works great in production for "Planio":http://plan.io, but we don’t guarantee it will work for you. 
17
18 5 Silviu Paragina
h2. Requirements
19
20
Note: this is probably not a complete list
21
* ruby inifiles 
22
<pre>
23
gem install inifile
24
</pre>
25
* ruby ssh2 library
26
for Debian/Ubuntu users:
27
<pre>
28
apt-get install libnet-ssh2-ruby1.8
29
</pre>
30
or 
31
<pre>
32
gem install net-ssh
33
</pre>
34
* ruby lockfile library
35
for Debian/Ubuntu users:
36
<pre>
37
apt-get install liblockfile-ruby
38
</pre>
39
or
40
<pre>
41
gem install lockfile
42
</pre>
43
44 4 Silviu Paragina
h2. Installation notes
45 2 Silviu Paragina
46 3 Silviu Paragina
* make sure the plugin folder is named redmine_gitosis and not redmine-gitosis (note "_" vs "-")
47
* you must setup a key with gitosis-admin write rights and copy it to /path/to/redmine/vendor/plugins/redmine_gitosis/extra/ssh/private_key
48
** for some misterious reason I had to copy the key in ~/.ssh/id for the user running passenger (but under mongrel it wasn't required)
49
* edit /path/to/redmine/vendor/plugins/redmine_gitosis/lib/gitosis.rb and fix the following
50
** GITOSIS_URI - this should be the uri for retrieving the gitosis-admin repository
51
** GITOSIS_BASE_PATH - this should be set to the path where gitosis stores the repositories (used for repository deletes only)
52
* after install each user should have a link, on the my account page, right next to the change password link
53 2 Silviu Paragina
54 1 Jan from Planio www.plan.io
h2. Resources & related discussion
55
56
* Ticket on redmine.org: #2525
57
* Forum thread: http://www.redmine.org/boards/1/topics/9909
58
59
h2. License
60
61
MIT
62
63
h2. Author
64
65
Jan Schulz-Hofen, "ROCKET RENTALS GmbH":http://rocket-rentals.de