项目管理和缺陷跟踪系统 Redmine

1. Redmine 概述

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

安装 Redmine 一些有用的知识点

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

https://bitnami.com/stack/redmine/installer

• 集成环境（Install Ruby on Rails）

https://railsinstaller.org/

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

• 集成环境（rubyinstaller）

https://rubyinstaller.org/downloads/

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

2. 安装 railsinstaller

• 下载railsinstaller

https://github.com/railsinstaller/railsinstaller-windows
https://railsinstaller.org/

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

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

安装完后的目录结构如下

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

3. 安装 Redmine

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

https://www.redmine.org/projects/redmine/wiki/RedmineInstall

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

• 下载 Redmine

下载地址如下

https://www.redmine.org/projects/redmine/wiki/Download

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

4. 配置 Redmine

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

• 创建数据库

create database redmine character set utf8mb4;

• 修改配置文件

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

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

• 安装 Redmine 依赖

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

cd redmine

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

gem install bundler

安装 bundler 可能遇到如下错误

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)

可以参考

https://www.cnblogs.com/smallbottle/p/4000825.html

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

bundle install --without development test

• 创建 Session 密钥

bundle exec rake generate_secret_token

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

• 创建数据库表结构

set RAILS_ENV=production
bundle exec rake db:migrate

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

• 设置数据库默认数据集

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

set RAILS_ENV=production
set REDMINE_LANG=zh
bundle exec rake redmine:load_default_data

• 启动 Redmine

bundle exec rails server webrick -e production

5. 访问 Redmine

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

http://127.0.0.1:3000

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