PluginGitosis » History » Revision 7
Revision 6 (Jan from Planio www.plan.io, 2010-08-08 02:06) → Revision 7/8 (Julian Dax, 2010-08-19 23:06)
h1. Gitosis Plugin
A Redmine plugin which manages your gitosis configuration based on your projects and memberships in Redmine. Includes Public Key management views (extracted from "*Planio Redmine Hosting*":http://plan.io/redmine-hosting/).
h2. Features
* Updates your Gitosis config (create repos, add keys, add access privileges)
* Allows users to upload public keys
h2. Getting the plugin
Please head over to "GitHub":http://github.com/rocket-rentals/redmine-gitosis to fetch the latest version.
h2. Release notes
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.
h2. Requirements
Note: this is probably not a complete list
* ruby inifiles
<pre>
gem install inifile
</pre>
* ruby ssh2 library
for Debian/Ubuntu users:
<pre>
apt-get install libnet-ssh2-ruby1.8
</pre>
or
<pre>
gem install net-ssh
</pre>
* ruby lockfile library
for Debian/Ubuntu users:
<pre>
apt-get install liblockfile-ruby
</pre>
or
<pre>
gem install lockfile
</pre>
h2. Installation notes
* make sure the plugin folder is named redmine_gitosis and not redmine-gitosis (note "_" vs "-")
* 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
** 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)
* edit /path/to/redmine/vendor/plugins/redmine_gitosis/lib/gitosis.rb and fix the following
** GITOSIS_URI - this should be the uri for retrieving the gitosis-admin repository
** GITOSIS_BASE_PATH - this should be set to the path where gitosis stores the repositories (used for repository deletes only)
* after install each user should have a link, on the my account page, right next to the change password link
h2. Resources & related discussion
* Ticket on redmine.org: #2525
* Forum thread: http://www.redmine.org/boards/1/topics/9909
h2. License
MIT
h2. Author
Jan Schulz-Hofen, "ROCKET RENTALS GmbH":http://rocket-rentals.de
h2. Forks
There is a redmine_gitosis fork at "GitHub":http://github.com/rocket-rentals/redmine-gitosis which contains some fixes and seems to be more active than the original project.