Skip to main content
Version: Next

Redmine

Redmine 是一个 一款基于WEB的项目管理软件,它被用于 云设施监控 需求/看板/缺陷 等场景。Redmine是用RUBY开发的基于WEB的项目管理软件,提供项目管理、WIKI、集成Git等功能。

gui

准备

在参阅本文档使用 Redmine 时,需要确保如下几点:

  • 应用是基于 Websoft9 安装的

  • 应用的用途符合 GPL-2.0 开源许可协议

  • 应用具备访问条件:配置域名服务器安全组开启网外端口

入门指南

初始化

Websoft9 控制台安装 Redmine 后,通过 "我的应用" 查看应用详情,在 "访问" 标签页中获取登录信息。

  1. 使用本地 Chrome 或 Firefox 浏览器访问后, 进入Redmine主页。

  2. 点击【登录】,进入系统 Redmine 密码

  3. 进入 Redmine 控制台,系统提示修改密码 Redmine 修改密码

  4. 打开:【项目】,新建一个项目 Redmine 新建项目

设置语言

  1. 依次打开:【管理】>【配置】>【显示】,设置 Redmine 项目区语言 Redmine 设置语言

  2. 依次打开:【管理】>【配置】>【用户】,设置 Redmine 用户语言(区别于项目区语言) Redmine SSH key

创建项目

下面以 Redmine 管理项目 作为一个任务,帮助用户快速入门:

  1. 登录 Redmine,依次打开:【项目】>【创建项目】

  2. 填写上面标题和英文缩写,保存

  3. 打开项目页面,开始工作

  4. 安装插件,增加更多所需的功能

安装和卸载插件

通过 Redmine 提供的插件中心可以扩展它的功能:

下面以一个具体的插件为例说明如何管理插件:

  1. 进入Ajax Redmine Issue Dynamic Edit 插件页面,获取其下载地址

  2. exec 到容器中,下载并解压插件到 /usr/src/redmine/plugins 中

    curl -L -o redmine_issue_dynamic_edit.zip https://www.redmine.org/attachments/download/25386/redmine_issue_dynamic_edit.zip && sudo unzip redmine_issue_dynamic_edit.zip -d /usr/src/redmine/plugins
  3. 重启 Redmine 后生效

  4. 登陆 Redmine 控制台查看插件

  5. 插件卸载操作相反,即只需删除插件对应的目录

配置选项

  • 站点目录:/path/data/redmine
  • 配置目录:/path/data/redmine/config
  • 配置文件://path/data/redmine/config/configuration.yml
  • CLI
  • API
  • SCM 支持:SVN, CVS, Git, Mercurial and Bazaar
  • 多语言(√)
  • Email Configuration

管理维护

设置 SMTP

  1. 修改 configuration.yml 文件,找到 “production:”, 在 production 下面添加并完善你的 SMTP 参数:

    production:
    delivery_method: :smtp
    smtp_settings:
    address: smtp.exmail.qq.com
    port: 465
    ssl: true
    enable_starttls_auto: true
    domain: websoft9.com
    authentication: :login
    user_name: help@websoft9.com
    password: ********

    注意缩进/空格,按照规定格式配置,否则Redmine报错

  2. 重启 Redmine 容器服务后生效

  3. 登录 Redmine 控制台,配置系统主机:【管理】-【配置】-【一般】-【主机名称】

  4. 配置系统邮件发件人地址:【管理】-【配置】-【邮件通知】-【邮件发件人地址】,保存,点击最下方“发送测试邮件”进行测试

备份与恢复

参考:《RedmineBackupRestore》

故障

新建工程名为中文时,系统报错?

数据库字符编码导致,需修改数据库字符编码为 utf8

新注册用户不能登录?

新注册用户需要激活:通过【管理】>【用户】,在【状态】选项中选择 已注册用户,然后激活用户,该用户才能登陆。