1. Redmine 概述

Redmine 是用 Ruby 开发的基于 web 的项目管理软件，是用 ROR 框架开发的一套跨平台项目管理系统，支持多种数据库，有不少自己独特的功能，例如提供 wiki、新闻台等。还可以集成其他版本管理系统和 BUG 跟踪系统；例如 SVN、CVS、TD 等。这种 Web 形式的项目管理系统通过项目（Project）的形式把成员、任务（问题）、文档、讨论以及各种形式的资源组织在一起，项目成员参与更新任务、文档等内容来推动项目。

安装 Redmine 一些有用的知识点

• Redmine 集成环境（Redmine packaged by Bitnami ）

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">https://bitnami.com/stack/redmine/installer</pre>

• 集成环境（Install Ruby on Rails）

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">https://railsinstaller.org/</pre>

RailsInstaller 向 Windows 开发者提供了一种便捷的方式以轻松、快速创建 Ruby on Rails 3 应用。到目前为止，Windows 开发者需要搭建好 Ruby、RubyGems、Rails 以及 SQLite 才能开始创建 Rails 应用。

• 集成环境（rubyinstaller）

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">https://rubyinstaller.org/downloads/</pre>

• 开发者准备Ruby环境搭建的所有的软件，并且必须考虑依赖性，进行安装。

2. 安装 railsinstaller

• 下载railsinstaller

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">https://github.com/railsinstaller/railsinstaller-windows
https://railsinstaller.org/</pre>

下载下来是一个exe安装文件，直接双击执行；同意安装协议后，点击Next>

image.png

可以自定义安装目录，无需安装 Git，把 Git 的勾选去掉。

安装完后的目录结构如下

image.png

同时会在 C: 盘，生成一个 Sites 文件夹；该文件夹的作用，就是用来存放项目的。Redmine 项目的部署目录就是该目录。

3. 安装 Redmine

安装的 Redmine 的版本一定要跟 railsinstaller 的 Ruby对应，具体对应关系参考：

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">https://www.redmine.org/projects/redmine/wiki/RedmineInstall</pre>

从第二步安装的 railsinstaller 得知 Ruby 的版本是 2.3.3；所以只能下载 Redmine 4.1版本，及比这个版本低的版本

image.png

• 下载 Redmine

下载地址如下

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">https://www.redmine.org/projects/redmine/wiki/Download</pre>

将 redmine-4.1.6.zip解压到 Sites 目录，并且将文件夹名称修改为redmine，如下：

image.png

4. 配置 Redmine

Redmine 依赖数据库，这里使用 MySQL 数据库；请自行安装 MySQL 数据库服务。

• 创建数据库

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">create database redmine character set utf8mb4;</pre>

• 修改配置文件

打开 C:\Sites\redmine\config ，找到database.yml.example配置文件；复制一份，然后重命名为database.yml，修改 production 部分配置。修改如下

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">production:
adapter: mysql2
database: redmine
host: localhost
username: root
password: root
port: 3306

Use "utf8" instead of "utfmb4" for MySQL prior to 5.7.7

encoding: utf8mb4</pre>

• 安装 Redmine 依赖

打开 RailsInstaller 的命令行窗口 Command Prompt with Ruby and Rails，进入 redmine 项目目录

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">cd redmine</pre>

image.png

如果Ruby 2.5 或者更低版本的 Ruby；先安装 bundler

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">gem install bundler</pre>

安装 bundler 可能遇到如下错误

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">C:\Sites>gem install bundler
ERROR: Could not find a valid gem 'bundler' (>= 0), here is why:
Unable to download data from https://rubygems.org/ - SSL_connect returned=1 errno=0 state=error: certificate verify failed (https://api.rubygems.org/specs.4.8.gz)</pre>

可以参考

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">https://www.cnblogs.com/smallbottle/p/4000825.html</pre>

执行下面的命令安装 Redmine 的所有依赖项

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">bundle install --without development test</pre>

• 创建 Session 密钥

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">bundle exec rake generate_secret_token</pre>

生成一个随机密钥，Rails 使用该密钥对存储会话数据的 cookie 进行编码，从而防止它们被篡改。重新启动后，生成新的秘密令牌会使所有现有会话无效。

• 创建数据库表结构

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">set RAILS_ENV=production
bundle exec rake db:migrate</pre>

将在 MySQL 数据库创建 Redmine 的相关表机构

image.png

• 设置数据库默认数据集

默认情况下是汉语的；所以不需要进行语言切换；如果需切换

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">set RAILS_ENV=production
set REDMINE_LANG=zh
bundle exec rake redmine:load_default_data</pre>

• 启动 Redmine

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">bundle exec rails server webrick -e production</pre>

image.png

5. 访问 Redmine

Redmine的默认端口是3000，默认用户是 admin / admin，所以访问地址是

<pre class="cm-s-default" style="font-family: Monaco, Menlo, Consolas, "Courier New", monospace !important; -webkit-font-smoothing: antialiased; margin: 0px; padding: 0px; font-size: 14px; overflow: auto; line-height: 1.45; background: none 0% 0% / auto repeat scroll padding-box border-box rgba(0, 0, 0, 0); color: rgb(89, 89, 89);">http://127.0.0.1:3000</pre>

image.png

登录后进行先进行秘密修改，修改后进入主界面。至此完成 Redmine 的安装。