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)
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,所以访问地址是
登录后进行先进行秘密修改,修改后进入主界面。至此完成 Redmine 的安装。