项目管理和缺陷跟踪系统 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.png4. 配置 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.png5. 访问 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 的安装。