跳到主要内容
版本：2.0

Redmine

Redmine 是一个 一款基于WEB的项目管理软件，它被用于 需求/看板/缺陷 项目/任务/流程 一站式 DevOps 应用 等场景。Redmine是用RUBY开发的基于WEB的项目管理软件，提供项目管理、WIKI、集成Git等功能。

gui

准备​

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

  • 登录 Websoft9 控制台，然后找到（或安装）Redmine：

    • 我的应用 菜单找到应用
    • 应用商店 菜单部署应用

  • 应用是基于 Websoft9 安装的

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

  • 为应用准备配置访问方式：配置域名 或 服务器安全组开启网外端口

入门指南​

登陆重置密码​

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

  2. 进入 Redmine 界面后，点击右上角登录

  3. 根据系统提示，修改密码后正式访问控制台

管理插件​

获取匹配的插件版本后，两个步骤即可安装插件：

  1. 将插件下载解压（或 git clone）到 Redmine 容器目录 /usr/src/redmine/plugins 中
  2. 重启 Redmine 容器后生效

插件版本不匹配会导致容器无法启动，需立即删除插件

下载插件范例​

# 下载并解压插件
apt update -y && apt install unzip
curl -L -o plugin_name.zip https://url/plugin_name.zip
unzip plugin_name.zip -d /usr/src/redmine/plugins

# git clone 插件
cd /usr/src/redmine/plugins
git clone https://github.com/Ilogeek/redmine_issue_dynamic_edit.git

卸载插件​

删除插件目录，即卸载插件

迁移插件​

如果 Redmine 容器中的插件目录已经挂载到宿主机，那么升级 Redmine 时，插件可能无法适用新的 Redmine 版本而导致 Redmine 升级失败。

Redmine 插件的 ruby 版本以及 gem 包依赖可能会与 Redmine 主程序产生冲突，导致 Redmine 无法启动。

因此，Websoft9 标准的 Redmine 启动程序并没有将容器中的插件目录挂载到宿主机。

正确的做法是：在升级 Redmine 之前，需要将插件目录移动到其他位置作为备份，待 Redmine 升级成功后，方可将插件逐一拷贝到插件目录。

设置 SMTP​

  1. Redmine 编排模式下，修改 configuration.yml 文件中的 SMTP 相关参数

    • 确保 SMTP 主机/账号/密码等准确无误
    • 注意缩进/空格，否则 Redmine 报错 
      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: [email protected]
          password: ********

  2. 重启 Redmine 容器后生效

  3. Redmine 控制台设置 SMTP：管理 > 配置 > 邮件通知

配置选项​

  • 插件中心（✅）
  • 多语言（✅）：支持项目多语言和用户多语言
  • 容器数据目录（已挂载）：/usr/src/redmine/files
  • 容器配置文件（已挂载）：/usr/src/redmine/config/configuration.yml
  • 容器插件目录：/usr/src/redmine/files/plugins
  • CLI
  • SMTP

管理维护​

故障​

工程名为中文时，系统报错？​

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

新注册用户不能登录？​

需管理员在后台激活，方可登陆

安装插件导致 Redmine 无法启动？​

问题分析：这个现象是正常的，因为安装插件可能会改变依赖包版本，使得 Redmine 主程序无法启动。
解决方案：删除插件目录，重启 Redmine