PluginGitosis » History » Version 5

Silviu Paragina, 2010-04-22 18:39

1 1 Jan from Planio www.plan.io
h1. Gitosis Plugin
2 1 Jan from Planio www.plan.io
3 1 Jan from Planio www.plan.io
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 1 Jan from Planio www.plan.io
5 1 Jan from Planio www.plan.io
h2. Features
6 1 Jan from Planio www.plan.io
7 1 Jan from Planio www.plan.io
* Updates your Gitosis config (create repos, add keys, add access privileges)
8 1 Jan from Planio www.plan.io
* Allows users to upload public keys
9 1 Jan from Planio www.plan.io
10 1 Jan from Planio www.plan.io
h2. Getting the plugin
11 1 Jan from Planio www.plan.io
12 1 Jan from Planio www.plan.io
Please head over to "GitHub":http://github.com/rocket-rentals/redmine-gitosis to fetch the latest version.
13 1 Jan from Planio www.plan.io
14 1 Jan from Planio www.plan.io
h2. Release notes
15 1 Jan from Planio www.plan.io
16 1 Jan from Planio www.plan.io
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 1 Jan from Planio www.plan.io
18 5 Silviu Paragina
h2. Requirements
19 5 Silviu Paragina
20 5 Silviu Paragina
Note: this is probably not a complete list
21 5 Silviu Paragina
* ruby inifiles 
22 5 Silviu Paragina
<pre>
23 5 Silviu Paragina
gem install inifile
24 5 Silviu Paragina
</pre>
25 5 Silviu Paragina
* ruby ssh2 library
26 5 Silviu Paragina
for Debian/Ubuntu users:
27 5 Silviu Paragina
<pre>
28 5 Silviu Paragina
apt-get install libnet-ssh2-ruby1.8
29 5 Silviu Paragina
</pre>
30 5 Silviu Paragina
or 
31 5 Silviu Paragina
<pre>
32 5 Silviu Paragina
gem install net-ssh
33 5 Silviu Paragina
</pre>
34 5 Silviu Paragina
* ruby lockfile library
35 5 Silviu Paragina
for Debian/Ubuntu users:
36 5 Silviu Paragina
<pre>
37 5 Silviu Paragina
apt-get install liblockfile-ruby
38 5 Silviu Paragina
</pre>
39 5 Silviu Paragina
or
40 5 Silviu Paragina
<pre>
41 5 Silviu Paragina
gem install lockfile
42 5 Silviu Paragina
</pre>
43 5 Silviu Paragina
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 3 Silviu Paragina
* 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 3 Silviu Paragina
** 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 3 Silviu Paragina
* edit /path/to/redmine/vendor/plugins/redmine_gitosis/lib/gitosis.rb and fix the following
50 3 Silviu Paragina
** GITOSIS_URI - this should be the uri for retrieving the gitosis-admin repository
51 3 Silviu Paragina
** GITOSIS_BASE_PATH - this should be set to the path where gitosis stores the repositories (used for repository deletes only)
52 3 Silviu Paragina
* 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 1 Jan from Planio www.plan.io
56 1 Jan from Planio www.plan.io
* Ticket on redmine.org: #2525
57 1 Jan from Planio www.plan.io
* Forum thread: http://www.redmine.org/boards/1/topics/9909
58 1 Jan from Planio www.plan.io
59 1 Jan from Planio www.plan.io
h2. License
60 1 Jan from Planio www.plan.io
61 1 Jan from Planio www.plan.io
MIT
62 1 Jan from Planio www.plan.io
63 1 Jan from Planio www.plan.io
h2. Author
64 1 Jan from Planio www.plan.io
65 1 Jan from Planio www.plan.io
Jan Schulz-Hofen, "ROCKET RENTALS GmbH":http://rocket-rentals.de