Skip to content

Commit

Permalink
fix redmine
Browse files Browse the repository at this point in the history
  • Loading branch information
chendelin1982 committed May 1, 2024
1 parent 913b0ad commit e00ff3b
Show file tree
Hide file tree
Showing 2 changed files with 44 additions and 85 deletions.
3 changes: 2 additions & 1 deletion docs/apps/discuz.md
Expand Up @@ -35,7 +35,8 @@ Discuz 有非常强大生态,官方[应用中心](https://addon.dismall.com/)

## 配置选项{#configs}

- 配置文件: */path/config/config_default.php*
- Discuz 配置文件(已挂载) */var/www/html/config/config_default.php*
- PHP 配置文件(已挂载) */usr/local/etc/php/conf.d/php_exra.ini*
- 多语言(×)
- 移动端:官方没有提供移动端
- 上传附件限制:**用户组**编辑页面中的 "论坛相关" > "附件相关" 菜单进行设置
Expand Down
126 changes: 42 additions & 84 deletions docs/apps/redmine.md
Expand Up @@ -12,106 +12,64 @@ import Meta from './_include/redmine.md';

## 入门指南{#guide}

### 初始化{#wizard}
### 登陆重置密码{#wizard}

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

1. 使用本地 Chrome 或 Firefox 浏览器访问后, 进入Redmine主页。
2. 进入 Redmine 界面后,点击右上角【登录】

2. 点击【登录】,进入系统
![Redmine 密码](https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-login-websoft9.png)
3. 根据系统提示,修改密码后正式访问控制台

3. 进入 Redmine 控制台,系统提示修改密码
![Redmine 修改密码](https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-resetpwf-websoft9.png)
### 管理插件

4. 打开:【项目】,新建一个项目
![Redmine 新建项目](https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-createproject-websoft9.png)
获取匹配的插件版本后,将插件下载解压到 Redmine 容器目录 */usr/src/redmine/plugins* 中,即安装插件

### 设置语言

1. 依次打开:【管理】>【配置】>【显示】,设置 Redmine 项目区语言
![Redmine 设置语言](https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-language-websoft9.png)

2. 依次打开:【管理】>【配置】>【用户】,设置 Redmine 用户语言(区别于项目区语言)
![Redmine SSH key](https://libs.websoft9.com/Websoft9/DocsPicture/en/redmine/redmine-userlanguage-websoft9.png)

### 创建项目

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

1. 登录 Redmine,依次打开:【项目】>【创建项目】
![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-createproject001-websoft9.png)

2. 填写上面标题和英文缩写,保存
![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-createproject002-websoft9.png)

3. 打开项目页面,开始工作
![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-createproject003-websoft9.png)

4. [安装插件](#plugin),增加更多所需的功能

### 安装和卸载插件

通过 Redmine 提供的[插件中心](https://www.redmine.org/plugins)可以扩展它的功能:

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

1. 进入[Ajax Redmine Issue Dynamic Edit](https://www.redmine.org/plugins/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 控制台查看插件
![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-installplugindy-websoft9.png)

5. 插件卸载操作相反,即只需删除插件对应的目录
- 重启容器后生效
- 容器下载解压的命令如下
```
apt update -y && apt install unzip
curl -L -o plugin_name.zip https://www.redmine.org/attachments/download/plugin_name.zip
unzip rplugin_name.zip -d /usr/src/redmine/plugins
```
- 卸载插件即删除插件目录
- 插件版本不匹配会导致容器无法启动,需卸载插件

## 配置选项

- 站点目录:*/path/data/redmine*
- 配置目录:*/path/data/redmine/config*
- 配置文件:*//path/data/redmine/config/configuration.yml*
- [插件中心](https://www.redmine.org/plugins)(✅)
- 多语言(✅):支持项目多语言和用户多语言
- 站点目录(已挂载):*/usr/src/redmine*
- 配置目录(已挂载):*/usr/src/redmine/config*
- 配置文件(已挂载):*/usr/src/redmine/config/configuration.yml*
- [CLI](https://pypi.org/project/Redmine-CLI/)
- [API](https://www.redmine.org/projects/redmine/wiki/Rest_api)
- SCM 支持:SVN, CVS, Git, Mercurial and Bazaar
- 多语言(√)
- [Email Configuration](https://www.redmine.org/projects/redmine/wiki/EmailConfiguration)
- [SMTP](https://www.redmine.org/projects/redmine/wiki/EmailConfiguration)

## 管理维护{#administrator}

### 设置 SMTP{#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报错
1. Redmine 容器中修改 `configuration.yml` 文件,在 production 下添加 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: help@websoft9.com
password: ********
```

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


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

![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-sethost-websoft9.png)

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

![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/redmine/redmine-smtp-websoft9.png)
3. Redmine 控制台设置 SMTP:“管理” > "配置" > "邮件通知"


### 备份与恢复
Expand All @@ -120,11 +78,11 @@ Websoft9 控制台安装 Redmine 后,通过 "我的应用" 查看应用详情

## 故障

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

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

#### 新注册用户不能登录?

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

0 comments on commit e00ff3b

Please sign in to comment.