国产开源项目管理软件ZenTao

本文应网友 ukiyoec 要求而写;

什么是禅道 ?

禅道 (ZenTao)是国产开源项目管理软件。它集产品管理、项目管理、质量管理、文档管理、组织管理和事务管理于一体,是一款专业的研发项目管理软件,完整覆盖了研发项目管理的核心流程。禅道管理思想注重实效,功能完备丰富,操作简洁高效,界面美观大方,搜索功能强大,统计报表丰富多样,软件架构合理,扩展灵活,有完善的API可以调用。

老苏应该是 2013 年开始用的,当然那时候的版本跟现在的版本肯定是不太一样的,目前禅道分为 开源版企业版旗舰版

各版本的差异可以去看看官方文档:https://www.zentao.net/book/zentaopms/961.html

对于小微企业,开源版 就很好用了, 测试管理可以很方便跟踪软件开发中的 BUG

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 zentao ,选择第二个 easysoft/zentao,版本选择 latest

  • 虽然第一个下载量更大,但是第二个才是禅道官方提供
  • 老苏折腾时,latest 版对应的版本是 18.3
  • pro 开头的是 专业版,应该就是前面说的 旗舰版 吧,biz 开头的是 企业版,只有纯数字的才是 开源版

docker 文件夹中,创建一个新文件夹 zentao,并在其中建两个子文件夹,分别是 datapms

文件夹 装载路径 说明
docker/zentao/data /var/lib/mysql 存放 mysql 数据库文件
docker/zentao/pms /www/zentaopms 存放禅道代码、附件等数据

端口

本地端口不冲突就行,不确定的话可以用命令查一下

1
2
# 查看端口占用
netstat -tunlp | grep 端口号
本地端口 容器端口 说明
4430 80 网页端口
4406 3306 数据库端口

默认没有对外暴露端口

网页端口是必现要添加的,数据库的话看个人需要了,如果你并不打算从外部直接修改数据库,不建议把数据库暴露出来

环境

可变
MYSQL_ROOT_PASSWORD 数据库 root 用户的密码,默认为 123456

如果你对外暴露了数据库端口,这个密码一定要改,不对外的暴露的话,默认也可以

命令行安装

如果你熟悉命令行,可能用 docker cli 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 新建文件夹 zentao 和 子目录
mkdir -p /volume2/docker/zentao/{data,pms}

# 进入 zentao 目录
cd /volume2/docker/zentao

# 运行容器
docker run -d \
--restart unless-stopped \
--name zentao \
-p 4430:80 \
-v $(pwd)/pms:/www/zentaopms \
-v $(pwd)/data:/var/lib/mysql \
-e MYSQL_ROOT_PASSWORD=123456 \
easysoft/zentao

也可以用 docker-compose 安装,将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
version: '3'

services:
zentao:
image: easysoft/zentao
container_name: zentao
restart: unless-stopped
ports:
- 4430:80
volumes:
- ./data:/var/lib/mysql
- ./pms:/www/zentaopms
environment:
- MYSQL_ROOT_PASSWORD=123456

然后执行下面的命令

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 zentao 和 子目录
mkdir -p /volume2/docker/zentao/{data,pms}

# 进入 zentao 目录
cd /volume2/docker/zentao

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

要多等一会儿,刚开始日志也是没有的

这个时候首先是在往 pms 目录中写入文件,然后是在 data 中写数据库文件,这个时候你访问 http://群晖IP:4430 只会看到错误页面

直到在日志中看到 Starting MariaDB database server mysqld...done. 应该就可以开始访问了

也不是每次都一样

等待的时间因机器而异吧,第一次运行会有设置向导

第一步是协议,默认已勾选,只要点 下一步

第二步上环境检测,在容器中一般是不会有问题的,继续点 下一步

第三步生产配置文件,输入密码后点 保存

数据库密码默认为 123456,除非你用环境变量 MYSQL_ROOT_PASSWORD 重新设置了新的密码

千万注意,只要点一次 保存 按钮,因为按钮没有灰,看起来像没有反应,大家会习惯性的连续点 保存而导致错误

如果遇到了也不要担心,只要删除 datapms 目录中的内容,然后重启容器就可以了,相当于重新再来一遍

如果只点了一次 保存,稍等一会儿会显示保存配置文件的内容和路径

老苏选择了 使用全生命周期管理模式

设置账号、密码

如果你设置的是弱密码,系统会提示

成功安装完成后,点 登录禅道管理系统 开始使用

输入账号、密码

登录成功后的主界面

参考文档

Docker方式部署禅道 - 禅道开源版使用帮助 - 禅道开源项目管理软件
地址:https://www.zentao.net/book/zentaopmshelp/405.html