Redmine

2020年11月23日 (一) 10:29的版本

您可以在Wikipedia上了解到此条目的英文信息 Redmine Thanks, Wikipedia.

redMine is a flexible project management web application. Written using Ruby on Rails framework, it is cross-platform and cross-database.

redMine is open source and released under the terms of the GNU General Public License (GPL).

简介

Redmine 是一款基于 Ruby on Rails 构建的开源项目管理软件，采用 GPLv2 许可证。

新闻

自https://www.redmine.org/projects/redmine/news.atom加载RSS失败或RSS源被墙

版本

功能

• Multiple projects support
• Flexible role based access control.
• Flexible issue tracking system
• Gantt chart and calendar
• News, documents & files management
• Feeds & email notifications.
• Per project wiki
• Per project forums
• Simple time tracking functionality
• Custom fields for issues, projects and users
• Repository integration (SVN, CVS, Mercurial and Darcs)
• Multiple LDAP authentication support
• User self-registration support
• Multilanguage support
• Multiple databases support

more redmine features: http://www.redmine.org/wiki/redmine/Features

Repository

• Git
• Subversion
• Mercurial
• CVS
• Darcs
• Bazaar

Download

Latest source

You can checkout the latest source from the SVN repository trunk.

svn checkout svn://rubyforge.org/var/svn/redmine/trunk

Or

svn checkout http://redmine.rubyforge.org/svn/trunk/

download Latest release from

• http://rubyforge.org/frs/?group_id=1850
• http://download.huihoo.com/redmine

指南

Debian

apt-get install redmine
apt-get install redmine-mysql // use MySQL
apt-get install redmine-pgsql // use PostgreSQL

4.x

Installing Redmine

$ bundle exec rails server webrick -e production

换成 Phusion Passenger

gem "passenger", ">= 5.3.2", require: "phusion_passenger/rack_handler"
$ bundle install
$ bundle exec passenger --version
$ bundle exec rails server passenger -e production // 并且同时安装了 Nginx，Server: nginx/1.18.0 + Phusion Passenger 6.0.7 
http://localhost:3000
admin:admin

2.3

gem install bundler
bundle install --without development test
bundle install --without development test rmagick
rake generate_secret_token
RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data
ruby script/rails server webrick -e production
http://localhost:3000
admin:admin

2.0.x

Installing Redmine

在Mac OS X可能出现的问题：

• uninitialized constant MysqlCompat::MysqlRes

sudo env ARCHFLAGS="-arch x86_64" gem install mysql -- --with-mysql-config=/usr/local/mysql/bin/mysql_config

• mac下undefined method `init' for Mysql:Class

export DYLD_LIBRARY_PATH=/usr/local/mysql/lib/

ruby script/rails server webrick -e production

1.4.x

在 NetBeans 6.0 下编译 redMine

安装 Ruby:

Linux/UNIX

http://download.huihoo.com/ruby/
tar xzvf ruby-1.8.6.tar.gz
cd ruby-1.8.6
./configure –prefix=/usr/local/ruby
make && make install
修改 .bashrc
export PATH=/usr/local/ruby/bin:$PATH
http://download.huihoo.com/ruby/rubygems-0.8.11.zip
unzip rubygems-0.8.11.zip
cd rubygems-0.8.11
ruby setup.rb
gem install rake

Windows

http://download.huihoo.com/ruby/

安装 Rails:

http://download.huihoo.com/rails/

按顺序安装

gem install activesupport-1.4.2.gem
gem install activerecord-1.15.3.gem
gem install actionpack-1.13.3.gem
gem install actionmailer-1.3.3.gem
gem install actionwebservice-1.2.3.gem
gem install rails-1.2.3.gem   
rails -v 显示Rails 1.2.3 :)

注意：若先前安装了JRuby可能安装会出现问题，建议安装前删除jruby目录

通过NetBeans IDE 6.0 > New Project > Ruby > Ruby on Rails Application with Existing Sources 导入 redmine-0.6.0

选择 Ruby Interpreter 是 Ruby // JRuby编译redmine有问题

创建数据库, 在 mysql 中创建以下数据库:

• redmine
• redmine_development
• redmine_test

这样创建: CREATE DATABASE test DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

cd redmine-0.6.0/config copy database.yml.exmple to database.yml

修改 Configuration>database.yml中的mysql连接信息

导入原始数据:

In the Projects window, right-click the readmin-0.6.0 project node and choose Migrate Database > To Current Version from the pop-up menu.

安装成功，启动应用:

right-click the readmin-0.6.0 project node and choose Run
http://localhost:3000 :)

或

Create an empty database: "redmine" 
CREATE database redmine DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
rake db:migrate RAILS_ENV="production" // linux 下可能要做个符号链接 ln -s /var/lib/mysql/mysql.sock /tmp/mysql.sock
rake redmine:load_default_data RAILS_ENV="production"
ruby script/server -e production   
http://localhost:3000/
用户信息: admin/admin

目前在Windows上可能会出现的严重错误是当点击版本库时(与Subversion的绑定)，系统会自动停止，并删除了Ruby等执行文件(没注意是不是卡巴斯基的问题)。之后 Ruby,Rails等应用就无法再启动。需重新安装 Ruby

部署到 Apache HTTPD上

命令行下编译:

Requirements

• Ruby 1.8.6
• Rails >= 1.2.2

先卸载Ruby 1.8.5, 再重新安装 Ruby 1.8.6

$ gem list --local
# gem install rails --include-dependencies 

1. Uncompress the program archive

2. Create an empty database: "redmine" for example

3. Configure database parameters in config/database.yml

  for "production" environment (default database is MySQL)

4. Create the database structure. Under the application main directory:

  rake db:migrate RAILS_ENV="production"
  It will create tables and an administrator account.

5. Insert default configuration data in the database:

  rake redmine:load_default_data RAILS_ENV="production"
  It will load default roles, trackers, statuses, workflows and enumerations.
  This step is optional but *highly recommended*

6. Test the installation by running WEBrick web server:

  ruby script/server -e production   
 
  Once WEBrick has started, point your browser to http://localhost:3000/
  You should now see the application welcome page

7. Use default administrator account to log in:

  login: admin
  password: admin
  

8. You can go to "Admin -> Settings" to modify application settings.

9. Setup Apache or Lighttpd with fastcgi for best performance.

升级

Upgrading

Database

数据库中表的定义在 redmine-0.6.0\db\schema.rb 中, 如：

  create_table "projects", :force => true do |t|
   t.column "name",           :string,   :limit => 30, :default => "",   :null => false
   t.column "description",    :string,                 :default => "",   :null => false
   t.column "homepage",       :string,   :limit => 60, :default => ""
   t.column "is_public",      :boolean,                :default => true, :null => false
   t.column "parent_id",      :integer
   t.column "projects_count", :integer,                :default => 0
   t.column "created_on",     :datetime
   t.column "updated_on",     :datetime
   t.column "identifier",     :string,   :limit => 20
   t.column "status",         :integer,                :default => 1,    :null => false
 end

PostgreSQL

创建 redmine, 格式为 UTF-8

修改database.xml

test_pgsql:
 adapter: postgresql
 database: redmine
 host: localhost
 username: postgres
 password: "postgres"

执行以下命令：

rake db:migrate RAILS_ENV="test_pgsql"

中文化

用UTF-8建立数据库后, 运行

rake db:migrate RAILS_ENV="devlopment"
rake redmine:load_default_data RAILS_ENV="developent"

select language: bg, cs, de, en, es, fr, he, it, ja, ko, nl, pl, sr, sv, zh[en] //默认是en,选择zh存入数据库的数据是乱码，但显示正确。

ruby script/server -e development

在这里要解决数据库乱码的问题

更多细节: redMine Chinese

持续集成

Continuous Integration Plugin

• A generic plugin for integrating per project RSS continuous integration feeds in Redmine.

svn co svn://rubyforge.org/var/svn/redmine/plugins/simple_ci 

http://www.redmine.org/wiki/1/PluginSimpleCI

• Travis-ci
• Hudson
• jenkins Associate CI build information in redmine issue by using redmine REST API

Mongrel

使用Mongrel异常简单, 使用的是plain HTTP而非FastCGI或SCGI.

Apache

• HowTo configure Apache to run Redmine
• Debian Squeeze/sid + Apache + Redmine 0.9.3/trunk + MySQL + git/hg
• 使用 Phusion Passenger：mod_rails or mod_rack

apt-get install libmysqlclient-dev libmysqld-dev
apt-get install apache2 libapache2-mod-passenger 
gem install passenger
gem install bundler 
gem install rake 
cd /home/huihoo/redmine
bundle install // 安装redmine依赖的包
chmod -R g+w redmine
chown -R root:www-data redmine

<VirtualHost *:80>

   ServerName forge.huihoo.com
   DocumentRoot /home/huihoo/redmine/public
   <Directory /home/huihoo/redmine/public>
       Allow from all
       Options -MultiViews
   </Directory>

</VirtualHost>

进程信息：

root     16947  0.0  0.8  81940  4344 ?        Ss   06:35   0:00 /usr/sbin/apache2 -k start
www-data 17122  0.0  0.4  81940  2116 ?        S    06:52   0:00 /usr/sbin/apache2 -k start
root     17133  0.0  0.3  89400  1752 ?        Sl   06:52   0:00 /usr/lib/phusion_passenger/ApplicationPoolServerExecutable 0 /usr/lib/phusion_passenger/passenger-spawn-server  /usr/bin/ruby  /tmp/passenger
root     17134  0.2  2.1  49464 10712 ?        Sl   06:52   0:03 Passenger spawn server                                                                                                                        
www-data 17138  0.0  0.7 303676  3928 ?        Sl   06:52   0:00 /usr/sbin/apache2 -k start
www-data 17166  0.0  0.6 303536  3276 ?        Sl   06:52   0:00 /usr/sbin/apache2 -k start
nobody   17198  1.1 28.4 227164 142316 ?       S    06:52   0:12 Rack: /var/www/redmine

Lighttpd

绑定Lighttpd可参考 Install_Ruby_Rails_Lighttpd_MySQL_on_Ubuntu_or_FreeBSD

Nginx

绑定Nginx

gem install mongrel

Nginx Ruby on Rails Mongrel http://wiki.codemongers.com/NginxRubyonRailsMongrel

SSO

集成 OpenSSO

travis-ci

与 travis-ci 持续集成的整合

插件

Plugins 提供 RedMine 的可扩展性, 使其 RedMine 成为类似 Eclipse 的插件系统。目前已有超过 1000 个插件数量，给力。

Plugin development

插件安装后，要更新下表：$ bundle exec rake redmine:plugins:migrate RAILS_ENV=production

To add plugin support to Redmine, install engines plugin:

  See: http://rails-engines.org/

Plugin installation

1. Copy the plugin directory into the vendor/plugins directory

2. Migrate plugin: rake db:migrate_plugins

3. Start Redmine, Installed plugins are listed on 'Admin -> Information' screen.

• Redmine Plugin List
• Plugin Tutorial
• Plugin Internals
• Plugin Hooks
• Plugin Hooks List

Git

Setup Git-Daemon

wget http://www.redmine.org/attachments/download/7399/git_daemon.txt -O /etc/init.d/git-daemon
chmod +x /etc/init.d/git-daemon
update-rc.d -f git-daemon defaults

enabled redmine 知道有 git repository 加进来

ruby script/rails "Repository.fetch_changesets" -e production ?
su - redmine -c "ruby script/runner "Repository.fetch_changesets" -e production"
or 
ruby script/rails runner "Repository.fetch_changesets" -e production

可能出现的错误：fatal: Not a git repository

路径可能这样：/Users/allen/git/huihoo/.git

• HowTo configure Redmine for advanced git integration
• Redmine、Apache、Git集成遇到的重重困难

Hudson

• Hudson Plugin 1.0.5

Scrum

• Redmine Agile Plugin: the best tool to manage your projects
• Redmine Backlogs
• Redmine Scrumdashboard plugin
• Redmine Sprints plugin 用户手册

Maven

整合Apache Maven

Chrome

• Chrome扩展
• Redmine-Issues-Checker

Themes

• Themes

Mobile

• RedTouch

Cloud

• Redmine on OpenShift

Links

• http://demo.redmine.org/
• redmine论坛: http://rubyforge.org/forum/?group_id=1850
• http://download.huihoo.com/redmine
• http://docs.huihoo.com/redmine/
• Huihoo Redmine demo

Developer

• Jean-Philippe Lang @ GitHub
• edavis10 (Eric Davis) @ GitHub

Python

• Python Redmine

PHP

• PHP Redmine API

.NET

• Redmine .NET API

用户

Who uses Redmine? 以及4万多家公司，遍及全球100个国家，正在使用RedmineUP出品的插件、主题和云服务。

• 灰狐协作
• Puppet Labs

Redmine Workflow for Puppet Open-Source Projects

• OpenNebula 集成了Hudson http://dev.opennebula.org/
• http://redmine.lighttpd.net/
• TYPO3 Forge - http://forge.typo3.org
• Redmine Hacks - http://www.redminehacks.org/
• IntelliSoft Systems - http://intellisoftsystems.com
• Makerlab - http://makerlab.com
• phpBB Code Forge - http://code.phpbb.com
• rVooz - http://redmine.rvooz.org/projects
• Applied Solutions - http://www.appsol.net
• SharpOS - http://sharpos.org/redmine
• Quake-World Dev - http://www.qw-dev.net/
• Ensemble OS - http://ensemble-os.org/
• Siemens (PG branch) - http://www.co2quickstart.co.uk/redmine/login
• Nebular Gauntlet - http://www.silentlink.com/
• Little Stream Software - https://projects.littlestreamsoftware.com
• OpenRain, LLC - (hidden Redmine) homepage: http://openrain.com/
• John Goerzen - 17 projects at http://software.complete.org/
• http://dev.ruby-lang.org.cn/
• 浙江大学研究生院信息化建设和管理平台

文档

• Redmine @ Huihoo

服务

• RedmineUP 专业Redmine插件以及专业的Redmine主题和服务
• Planio Redmine Hosting
• 灰狐协作

图集

• 

  Redmine1.3概念模型

• 

RedmineUP图集

• 

  敏捷面板

• 

  我的工作台

• 

  问题

• 

  问题列表

• 

  联系人列表

• 

  合同

• 

  Administration

• 

  Information

链接

• Redmine @ GitHub