Plugin Gems¶

• Table of contents
• Plugin Gems
  • Copyright
  • Description
  • Requierement
  • Download
  • Installation
  • Configuration
  • Utilisation
    • Human Processus
    • Building processus
  • Options

Copyright¶

Copyright (c) 2009 Romain GEORGES
Copyright Ultragreen (c) 2009
http://www.ultragreen.net
Under BSD license
http://www.opensource.org/licenses/bsd-license.php

• Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.co.jp>.
  Ruby under the Ruby License.
  http://www.ruby-lang.org/en/LICENSE.txt

• Rails is copyrighted free software by David Heinemeier Hansson
  Rails is released under the MIT license.
  http://www.opensource.org/licenses/mit-license.php
  "Rails", "Ruby on Rails", and the Rails logo are registered trademarks of David Heinemeier Hansson. All rights reserved.

• Redmine is copyrighted free software by Jean-Philippe Lang
  Redmine © 2006-2009 Jean-Philippe Lang
  Redmine is open source and released under the terms of the GNU General Public License v2 (GPL).
  http://www.opensource.org/licenses/gpl-2.0.php

Description¶

Automation Gems Building plugins for Redmine

Project Preview : http://www.ultragreen.net/projects/redmine-gems
SCM : http://www.ultragreen.net/projects/redmine-gems/files
ITS : http://www.ultragreen.net/projects/redmine-gems/issues

Requierement¶

This plugins requiers

- Ruby 1.8.6 or higher
- Rails 2.2.2 or higher
- Redmine trunk from r2493 to r2886 or higher

Warning : this plugin will operate ONLY if you have a SUBVERSION repository configured on the Redmine Project where it has been added.

Download¶

http://www.ultragreen.net/projects/redmine-gems/files

Installation¶

# cd $APP_ROOT
# cd vendors/plugins
# svn export https://svn.ultragreen.net/public/redmine-gems/tags/<lastest_tags> redmine-gems
# rake db:migrate_plugins RAILS_ENV=production

Reload Rails and Redmine.

Configuration¶

The plugin could be setup in the
Administration>Plugins menu

Configure link of the "Redmine Gems" plugin

You have to precise to paths in this configuration panel.

- SVN exportation path
- gemdir path (gem server) (optionnel)

You could use two permissions in this plugin with the

Administration>Roles and permissions menu

For all of the different profiles avaibles :

• permission : View rubygems,
• permission : Build rubygems

Plugin must be added in all the projects you would use it in.

Utilisation¶

Human Processus¶

When have install this plugins as a module in a project, a "Gems" tabs could be found in the project menu after the "Repository" tabs.
If you click on this tabs, the plugin start and you could see if you a have a configured SVN Repository with tags create in it "tags" folder (mandatory).
The plugin also could ask you to create Redmine version to attach, if none exists (mandatory).

1. if one/some SVN tags exists, plugin try to associate Redmine Version for each of this tags, if not you have to do this association yourself (select list).
2. Plugin will scan the tags folder root th find a Rakefile (with a least the clobber, clean or gem generic Gem/rake targets ) or a Gemspec (*.gemspec files), if this methods exists twice, you have to choose one (select list).
3. Plugin ask you some comments (optional).
4. Click on the "Build" button to start the Gem building

• Date.
• Builder.
• Associated Redmine Version.

Building processus¶

1. Plugin try to remove eventual old exports.
2. Plugin export the selected SVN tag.
3. Plugin change directory in the tags folder.
4. Plugin build Gem with the selected building method.
5. Plugin attach gem file in the 'Files' Redmine module under the specified version.
6. Plugin persist a building record (Rubygem Rails model) or modify existing one and add update date (display in the informations precised in the Gems building list).

The Rails model act as an activity and an event and the plugins as an Activity provider, so, in the "Activity" tab, you could see a message if you check (on the right side, in the default Redmine theme ) the box concerning Activities of the Redmine Gems

Options¶