Redmine

您可以在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源被墙

版本

Redmine版本	支持的Ruby版本	使用的Rails版本
trunk (>= r20154)	Ruby 2.4, 2.5, 2.6, 2.7	Rails 5.2
4.1	Ruby 2.3, 2.4, 2.5, 2.6	Rails 5.2
4.0	Ruby 2.2, 2.3, 2.4, 2.5, 2.6	Rails 5.2

功能

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

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

指南

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

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

   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.

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