Redmine支持插件方式对功能进行扩展,这篇文章就以Redmine下的敏捷开发插件Redmine Agile Plugin为例,介绍如何进行插件的安装。
事前环境准备
本文使用Redmine 3.4.11的镜像作为示例进行主题的安装与设定的介绍。环境的设定请参看如下内容(唯一不同的是所使用的Redmine的版本不同)
Redmine插件列表
从如下链接可以获取Redmine当前的插件列表
- https://www.redmine.org/plugins?utf8=✓&page=1&sort=&v=
截止到2019年6月11号为止,插件已经达到983个之多
而标明支持Redmine 4的插件也达到了163个。
Plugin安装
Plugin的安装一般只需要分为如下三步即可
- 步骤1: 下载Plugin压缩包
- 步骤2: 解压Plugin压缩包至Redmine的plugins目录下并执行bundle install与rake命令
- 步骤3: 重启Redmine服务
本文将以Redmine Agile Plugin为例,介绍起在Redmine 4.0.3上安装和设定的过程。
步骤1: 下载Plugin压缩包
从如下地址下载到Redmine Agile Plugin,本文使用的是免费的light版本。
步骤2: 解压&执行安装
- 解压
将下载下来的plugin的zip文件包解压至plugins目录下,执行示例命令如下所示:
# pwd
/usr/src/redmine
# cd plugins
# ls
README
# cp /tmp/*.zip .
# ls
README redmine_agile-1_4_11-light.zip
# unzip redmine_agile-1_4_11-light.zip
Archive: redmine_agile-1_4_11-light.zip
creating: redmine_agile/
inflating: redmine_agile/.drone.yml
...省略
inflating: redmine_agile/README.rdoc
#
# ls
README redmine_agile redmine_agile-1_4_11-light.zip
# rm redmine_agile-1_4_11-light.zip
# ls
README redmine_agile
#
- 执行安装
安装命令:
bundle install
bundle exec rake redmine:plugins NAME=redmine_agile RAILS_ENV=production
执行日志示例如下所示:
# pwd
/usr/src/redmine/plugins
# ls
README redmine_agile
#
# bundle install
...省略
Fetching gem metadata from https://rubygems.org/.............
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Using rake 12.3.2
Using concurrent-ruby 1.1.5
...省略
Using roadie-rails 1.3.0
Using rouge 3.3.0
Bundle complete! 27 Gemfile dependencies, 60 gems now installed.
Gems in the groups development and test were not installed.
Bundled gems are installed into `/usr/local/bundle`
# bundle exec rake redmine:plugins NAME=redmine_agile RAILS_ENV=production
(in /usr/src/redmine)
...省略
== 5 AddStoryPointsToAgileRanks: migrating ====================================
-- add_column(:agile_data, :story_points, :integer, {})
-> 0.0246s
== 5 AddStoryPointsToAgileRanks: migrated (0.0248s) ===========================
#
步骤3: 重启Redmine服务
重新启动Redmine服务,镜像方式的服务只需要重新启动Redmine进行即可。
结果确认
首先从Plugins页面可以确认到安装的此插件的概要信息
其次也能看到此Plugin相关页面显示
注意事项:
Plugin的版本和Redmine的版本需要进行兼容性确认,比如上述的1.4.11的Redmine Agile Plugin在Redmine 4.0.3上直接运行目前的状态就会运行出错,安装之后会导致Redmine服务无法正常启动,在安装的时候需要重点确认插件所支持的版本信息。