jackden / zentao-docker

Quickon Docker Image for ZenTao（禅道官方容器镜像）

QuickOn ZenTao 应用镜像

快速参考

• 通过 渠成软件百宝箱 一键安装 ZenTao
• Dockerfile 源码
• ZenTao 源码
• ZenTao 官网

一、关于 ZenTao

禅道是一款开源的全生命周期项目管理软件，基于敏捷和CMMI管理理念进行设计，集产品管理、项目管理、质量管理、文档管理、组织管理和事务管理于一体，完整地覆盖了项目管理的核心流程。

禅和道是**文化中极具代表意义的两个字，是**传统文化的结晶。我们之所以选用“禅道”作为我们软件的名字，是希望通过这两个字来传达我们对管理的理解和思考。我们希望通过禅道来进行的管理，可以摒弃繁文缛节，还原管理的本质！

ZenTao官网：https://zentao.net/

二、支持的版本(Tag)

由于版本比较多,这里只列出最新的5个版本,更详细的版本列表请参考:可用版本列表

镜像版本

镜像地址: easysoft/quickon-zentao

• 开源版

  • latest
  • 18.0-20230112
  • 17.8-20221205
  • 17.8-20221205
  • 17.7-20221028
  • 17.6.2-20220929
  • 17.6.1-20220916

• 企业版

  • biz8.0-20230112
  • biz8.0.k8s-20230112
  • biz7.8-20221205
  • biz7.8.k8s-20221108
  • biz7.7-20221028
  • biz7.7.k8s-20221028
  • biz7.6.2-20220929

• 旗舰版

  • max4.0-20230112
  • max4.0.k8s-20230112
  • max3.8-20221205
  • max3.8.k8s-20221108
  • max3.7-20221028
  • max3.7.k8s-20221028
  • max3.6.3-20220929

• 迅捷版

  • lite1.2-20221205

• 迅捷企业版

  • litevip1.2-20221205

三、获取镜像

推荐从 Docker Hub Registry 拉取我们构建好的官方Docker镜像。

docker pull easysoft/quickon-zentao:latest

如需使用指定的版本，可以拉取一个包含版本标签的镜像，在Docker Hub仓库中查看 可用版本列表

docker pull easysoft/quickon-zentao:[TAG]

四、持久化数据

禅道容器镜像做了特殊处理，将所有需要持久化的数据都保存到了 /data 目录，因此，运行禅道容器镜像，您只需要将持久化目录挂载到容器的 /data 目录即可。

如果挂载的目录为空，首次启动会自动初始化相关文件

$ docker run -it \
    -v $PWD/data:/data \
    easysoft/quickon-zentao:latest

或者修改 docker-compose.yml 文件，添加持久化目录配置

services:
  ZenTao:
  ...
    volumes:
      - /path/to/zentao-persistence:/data
  ...

五、环境变量

变量名	默认值	说明
DEBUG	false	是否打开调试信息，默认关闭
PHP_SESSION_TYPE	files	php session 类型，files | redis
PHP_SESSION_PATH	/data/php/session	php session 存储路径
PHP_MAX_EXECUTION_TIME	120	最大执行时间，单位秒，有助于防止有问题程序占尽服务器资源。默认120
PHP_MEMORY_LIMIT	256M	单个php进程允许分配的最大内存
PHP_POST_MAX_SIZE	128M	允许最大Post数据大小
PHP_UPLOAD_MAX_FILESIZE	128M	单个文件上传的最大值
MYSQL_HOST	127.0.0.1	MySQL 主机地址
MYSQL_PORT	3306	MySQL 端口
MYSQL_DB	zentao	zentao数据库名称
MYSQL_USER	root	MySQL用户名
MYSQL_PASSWORD	pass4zenTao	MySQL密码
LDAP_ENABLED	false	是否启用LDAP
LDAP_HOST	127.0.0.1	LDAP服务主机地址
LDAP_PORT	389	LDAP服务端口
LDAP_BASEDN	dc=quickon,dc=org	LDAP BaseDN
LDAP_ADMINUSER	cn=admin,dc=quickon,dc=org	LDAP 管理员
LDAP_BINDPASSWORD	pass4zenTao	LDAP Bind 密码
LDAP_USERKEY	uid	LDAP 用户名称的字段名
LDAP_EMAILKEY	mail	LDAP 用户邮箱的字段名
SMTP_ENABLED	false	启用SMTP
SMTP_FROMNAME	ZenTao $VERSION	SMTP发件人显示名称
SMTP_HOST	127.0.0.1	SMTP 服务主机地址
SMTP_PORT	25	SMTP 服务端口号
SMTP_USER	[e-mail]	SMTP发件人邮箱地址
SMTP_PASS	pass4zenTao	SMTP发件人邮箱密码
LINK_GIT	false	DevOps模块，是否链接Git服务
GIT_TYPE	gitea	连接的git服务名称，目前支持 gitea/gogs/gitlab
GIT_INSTANCE_NAME	gitea	Git 服务名称
GIT_USERNAME	root	Git 管理员账号名称，用于生成token
GIT_PASSWORD	pass4QuickOn	Git 管理员密码，用于生成token
GIT_PROTOCOL	https	Git 服务协议类型，http或https
GIT_DOMAIN	git.haogs.cn	Git 服务域名
LINK_CI	false	DevOps模块，是否链接CI服务
CI_TYPE	jenkins	连接的ci服务名称，目前支持 jenkins
CI_USERNAME	root	CI 管理员账号名称，用于生成token
CI_PASSWORD	pass4QuickOn	CI 管理员密码，用于生成token
CI_PROTOCOL	https	CI 协议类型，http或https
CI_URL	jenkins.haogs.cn	CI 服务域名
IS_CONTAINER	true	是否在容器内运行，zentao更新时使用

5.1 调整最大上传文件的限制

通过设置 PHP_POST_MAX_SIZE 、PHP_UPLOAD_MAX_FILESIZE 这两个环境变量的值来调整最大上传文件的限制，另外，如果考虑到用户网速的因素，建议把PHP_MAX_EXECUTION_TIME 也加大一些，这样可以保证用户的文件可以上传完成。

示例：

# 运行mysql
docker run -d --rm --name mysql -e MYSQL_ROOT_PASSWORD=pass4you mysql:5.7.38-debian

# 运行禅道
docker run -d --rm --name zentao \
--link mysql \
--link redis \
-e MYSQL_HOST=mysql \
-e MYSQL_PORT=3306 \
-e MYSQL_USER=root \
-e MYSQL_PASSWORD=pass4you \
-e MYSQL_DB=zentao \
-e PHP_MAX_EXECUTION_TIME=300 \
-e PHP_POST_MAX_SIZE=512M \
-e PHP_UPLOAD_MAX_FILESIZE=512M \
-v /data/zentao:/data \
-p 8088:80 \
easysoft/quickon-zentao:latest

• PHP_MAX_EXECUTION_TIME 设置为300秒
• PHP_POST_MAX_SIZE 设置为512M
• PHP_UPLOAD_MAX_FILESIZE 设置为 512M

六、将Session存储在Redis

禅道默认是将Session存储在共享存储中，因此多节点部署也可以满足Session共享的需求，但如果你想通过Redis来存储Session也是可以的，只需要在启动容器是传入两个参数即可：

• PHP_SESSION_TYPE
• PHP_SESSION_PATH

启动命令示例如下：

# 运行redis
docker run -d --rm --name redis redis:3.2.12-alpine3.8

# 运行mysql
docker run -d --rm --name mysql -e MYSQL_ROOT_PASSWORD=pass4you mysql:5.7.38-debian

# 运行禅道
docker run -d --rm --name zentao \
--link mysql \
--link redis \
-e MYSQL_HOST=mysql \
-e MYSQL_PORT=3306 \
-e MYSQL_USER=root \
-e MYSQL_PASSWORD=pass4you \
-e MYSQL_DB=zentao \
-e PHP_SESSION_TYPE=redis \
-e PHP_SESSION_PATH=tcp://redis:6379 \
-v /data/zentao:/data \
-p 8088:80 \
easysoft/quickon-zentao:latest

指定上面两个环境变量，实际上就是修改了php.ini中关于Session的配置：

session.save_handler = redis
session.save_path = "tcp://redis:6379"

注意：

• 镜像内的脚本已经做了特殊处理，因此环境变量的值加不加引号，都不影响正常使用。
• 示例使用了link的方式连接了mysql和redis，因此可以直接使用连接名称来连接mysql和redis。

七、运行

7.1 单机Docker-compose方式运行

# 启动开源版及相关的服务
make run

# 查看服务状态
make ps

# 查看服务日志
docker-compose logs -f quickon-zentao

说明:

• VERSION 文件中详细的定义了Makefile可以操作的版本
• docker-compose.yml

八、版本升级

容器镜像已为版本升级做了特殊处理，当检测数据（数据库/持久化文件）版本与镜像内运行的程序版本不一致时，会进行数据库结构的检查，并自动进行数据库升级操作。

因此，升级版本只需要更换镜像版本号即可：

修改 docker-compose.yml 文件

...
  zentao:
-    image: easysoft/quickon-zentao:17.3-20220729
+    image: easysoft/quickon-zentao:17.4-20220817
    container_name: zentao
...

更新服务

# 是用新版本镜像更新服务
docker-compose up -d

# 查看服务状态和镜像版本
docker-compose ps

九、其他

9.1 容器内安装软件

容器内临时安装软件，可以通过封装好的 /usr/sbin/install_packages 命令，该命令支持设置MIRROR参数，国内使用时，指定 MIRROR=true 会使用国内的加速源。实例如下：

export MIRROR=true;install_packages vim