在windows平台上安装部署redmine

客官°小女子只卖身不卖艺 2021-09-10 20:16 898阅读 0赞

项目管理工具是团队开发过程中必不可少的工具，比较流行的包括JIRA、trac、redmine、xplanner等。redmine系统以其轻量、易上手等特点吸引了越来越多人的注意，作为其特色的甘特图，也为其赢得了更多的称赞和口碑。  
redmine是一个支持中文的开源项目管理系统，基于Ruby on Rails，支持功能灵活而丰富：多项目、多数据库支持、bug跟踪、甘特图、文档管理、wiki、email、论坛、时间线等，基本能够满足大多数项目管理需求。下面来看看安装redmine需要的支持环境和安装步骤。（请参考各平台安装redmine的官方说明）  
在windows平台上安装部署redmine，需要以下条件：  
1、ROR环境：Ruby，RubyGems，Rake，Rails；  
2、数据库：mysql；  
3、redmine包。  
ROR环境的部署还是非常麻烦的，尤其是rake（一个类似于make的东东），需要很多库的支持。幸好有一个RailsInstaller的工具可以帮我们一键安装好ROR环境，这样我们也不用再去关心ROR组件中各版本的兼容问题，直接安装最新的[RailsInstaller][]包就好了。  
mysql的安装我是找了xampp的包，里面包含了mysql和Apache等，安装的时候可以自定义。  
具体步骤：  
1、安装RailsInstaller，注意勾选上添加环境变量，后面命令行运行ROR程序时会很方便。我直接安装在了C盘根目录下：C:\\RailsInstaller。此时RailsInstaller还会为我们自动创建一个ROR项目目录C:\\Sites。安装完成后会弹出一个dos窗口，会要求先设置git用户名和邮箱；  
2、下载redmine包（[http://www.redmine.org/releases/redmine-3.2.0.zip][http_www.redmine.org_releases_redmine-3.2.0.zip]），将解压后的redmine文件夹拷贝到C:\\Sites下，修改文件夹名字为redmine，即C:\\Sites\\redmine；  
3、替换libmysql.dll文件，由于RailsInstaller中的mysql编译版本问题，我们需要下载[http://dev.mysql.com/get/Downloads/Connector-C/mysql-connector-c-noinstall-6.0.2-win32.zip/from/pick][http_dev.mysql.com_get_Downloads_Connector-C_mysql-connector-c-noinstall-6.0.2-win32.zip_from_pick]，将解压后的 lib\\libmysql.dll 文件拷贝到 C:\\RailsInstaller\\Ruby1.9.3\\bin下；（注：以上参考在 Windows 下安装 Redmine 2中的说明）  
（笔者注：我这里直接用我自己配置的php环境中的mysql文件夹下的libmysql.dll也没问题）  
4、打开RailsInstaller的命令行程序“Command Prompt with Ruby and Rails”，默认在C:\\Sites路径下，输入“cd redmine”进入redmine目录。根据redmine安装说明，1.4.0版本以上的redmine用bundler来管理用到的gems，输入“gem install bundler”先安装bunlder。然后输入“bundle install –without development test rmagick”安装所有需要的gems；  
5、创建数据库。由于我本地已配置好php环境，可以用phpMyAdmin配置建立mysql数据库，也可以用命令行创建。如下所示：  
create database redmine character set utf8;  
create user ‘redmine’@’localhost’ identified by ‘my\_password’;  
grant all privileges on redmine.\* to ‘redmine’@’localhost’ identified by ‘my\_password’;  
（笔者注：我这里创建的redmine用户没有分配上redmine数据库的权限，后来在phpmyadmin中重新建的用户。）  
6、配置数据库。将C:\\Sites\\redmine\\config下的database.yml.example文件拷贝一份，改名为database.yml，打开文件进行编辑，主要目的是配置数据库的信息。由于我们bundler的时候去掉了development和test版本，所以只关注“production”部分就好了。修改如下：  
production:  
adapter: mysql2  
database: redmine  
host: localhost  
username: redmine  
password: my\_password  
其中密码部分对应创建数据库时的密码，要加引号；  
7、关联数据库。在“Command Prompt with Ruby and Rails”中进入redmine目录后输入“rake generate\_secret\_token  
”生成session存储密钥；然后输入“rake db:migrate RAILS\_ENV=”production””迁移redmine的数据库，需要等待几分钟；通过“rake redmine:load\_default\_data RAILS\_ENV=”production””装载默认配置数据，选择语言为zh。  
8、运行redmine。输入“ruby bin/rails server webrick -e production”启动redmine就大功告成了。在浏览器中输入“[http://localhost:3000/][http_localhost_3000]”就能看到redmine的界面了。详细的安装步骤还可以参考官方说明。  
如果需要用ip 访问，则启动的时候需要在后面加上参数 -b 10.10.10.10 -p 3000&  
![这里写图片描述][20160301152048264]  
除了以上说明的方法，还有一个工具集成了redmine的安装，参考BitNami。

## over！ ##

后续题外话：

由于国内网络原因（你懂的），导致 rubygems.org 存放在 Amazon S3 上面的资源文件间歇性连接失败。所以你会与遇到 gem install rack 或 bundle install 的时候半天没有响应，具体可以用 gem install rails -V 来查看执行过程。  
这是一个完整 rubygems.org 镜像，你可以用此代替官方版本，同步频率目前为15分钟一次以保证尽量与官方服务同步。  
如何使用？  
$ gem sources –remove [https://rubygems.org/][https_rubygems.org]  
$ gem sources -a [https://ruby.taobao.org/][https_ruby.taobao.org]  
$ gem sources -l  
**\* CURRENT SOURCES \***

[https://ruby.taobao.org][https_ruby.taobao.org 1]

# 请确保只有 ruby.taobao.org #

$ gem install rails  
如果你是用 Bundle (Rails 项目)  
source ‘[https://ruby.taobao.org/][https_ruby.taobao.org]’  
gem ‘rails’, ‘4.1.0’  
…  
Ruby 源代码镜像  
Ruby 源代码下载镜像  
本镜像来源于 cache.ruby-lang.org 用于改善国内 Ruby 安装的速度。  
ruby-2.1.2.tar.gz  
ruby-2.0.0-p451.tar.gz  
ruby-1.9.3-p545.tar.gz  
ruby-1.9.2-p320.tar.gz  
ruby-1.8.7-p358.tar.gz  
修改 RVM ，改用本站作为下载源, 提高安装速度。  
For Mac  
sed−i.bak′s!cache.ruby−lang.org/pub/ruby!ruby.taobao.org/mirrors/ruby!′rvm\_path/config/db  
For Linux  
sed−i′s!cache.ruby−lang.org/pub/ruby!ruby.taobao.org/mirrors/ruby!′rvm\_path/config/db

转自：[http://ruby.taobao.org/][http_ruby.taobao.org]

[RailsInstaller]: https://s3.amazonaws.com/railsinstaller/Windows/railsinstaller-3.2.0.exe
[http_www.redmine.org_releases_redmine-3.2.0.zip]: http://www.redmine.org/releases/redmine-3.2.0.zip
[http_dev.mysql.com_get_Downloads_Connector-C_mysql-connector-c-noinstall-6.0.2-win32.zip_from_pick]: http://dev.mysql.com/get/Downloads/Connector-C/mysql-connector-c-noinstall-6.0.2-win32.zip/from/pick
[http_localhost_3000]: http://localhost:3000/
[20160301152048264]: /images/20210825/4e69729422d248f9a4ef47c31be53453.png
[https_rubygems.org]: https://rubygems.org/
[https_ruby.taobao.org]: https://ruby.taobao.org/
[https_ruby.taobao.org 1]: https://ruby.taobao.org
[http_ruby.taobao.org]: http://ruby.taobao.org/