Project

General

Profile

PluginGitosis » History » Revision 6

Revision 5 (Silviu Paragina, 2010-04-22 18:39) → Revision 6/8 (Jan from Planio www.plan.io, 2010-08-08 02: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/). "Planio":http://plan.io).  

 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