项目管理和缺陷跟踪系统 Redmine
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 的安装。
