對比項	舊版	新版	說明
鏡像大小	342Mb	204Mb	压缩后鏡像大小
針對容器優化	否	是	新版优化了持久化目錄、配置与安装流程
渠成应用市場	否	是	通过渠成应用市場安装
集成MySQL	是	是	新版可通過環境變量控制是否使用內置MySQL
對接外部MySQL	是，手動修改my.php	是，通過環境變量
持久化目錄	禅道代碼+MySQL數據	禅道配置+用戶数据或 MySQL数据	新版镜像只需要挂载容器内 /data 目錄
禅道升級	下載源码包覆盖程序	拉取新版本鏡像
Dockerfile開源	否	是	新版Dockerfile源碼
docker-compose編排	否	是
Kubernetes運行	否	是
高可用部署	否	是
PHP配置修改	手動	環境變量	新版通过環境變量設置PHP参数
Session存儲	文件	文件或 Redis	新版通过環境變量設置
PHP配置修改	手動	環境變量	新版通过環境變量設置PHP参数
配置SMTP	手動	環境變量
配置LDAP	手動	環境變量	企業版、旗艦版支持
配置CI	手動	環境變量
配置Git服務	手動	環境變量

三、舊版升級流程

舊版升级流程.svg

3.1 備份数据

命令行进入到舊版容器内執行

# 查找禅道容器ID，默认容器名为 zentao，请根据实际情况填写禅道容器名
cid=$(docker ps -q --filter name=zentao)
# 查看舊版禅道服務的持久化目錄位置
docker inspect $cid | grep -B 1 "/www/zentaopms"                                                                                    
                "/tmp/zentao-db:/var/lib/mysql",
                "/tmp/zentao-files:/www/zentaopms"
--
                "Source": "/tmp/zentao-files",
                "Destination": "/www/zentaopms",
# 本示例的宿主机目錄分配是：
# MySQL目錄：/tmp/zentao-db
# 禅道目錄：/tmp/zentao-files
# 进入到禅道容器内
docker exec -it $cid bash
# 查看当前运行的禅道版本
cat /www/zentaopms/VERSION
max4.1    # 记住这个版本号，升级新版镜像时要用到
# 通过命令行備份禅道数据
# 切换到禅道工作目錄的bin目錄
cd /www/zentaopms/bin
# 根据当前配置生成備份脚本
bash init.sh
Please input your php path:(example: /usr/bin/php)
/usr/bin/php
Please input zentao url:(example: http://localhost:88/zentao or http://localhost)
http://localhost
ztcli.sh ok
backup.sh ok
computeburn.sh ok
computetaskeffort.sh ok
dailyreminder.sh ok
checkdb.sh ok
syncsvn.sh ok
syncgit.sh ok
sendmail.sh ok
sendwebhook.sh ok
createcycle.sh ok
initqueue.sh ok
checkbuildstatus.sh ok
execcompile.sh ok
deletelog.sh ok
encrypt.sh ok
cron.sh ok
# 通过backup.sh脚本備份禅道
bash backup.sh
備份成功！
# 備份文件存在 /www/zentaopms/tmp/backup 目錄，本示例文件如下：
ls -1 /www/zentaopms/tmp/backup
202303150937474.code       # 代码備份
202303150937474.file       # /www/zentaopms/www/data 目錄備份
202303150937474.sql.php    # 数据库備份
summary                    # 本次備份统计信息

3.2 启动新版禅道镜像

3.2.1 创建新版禅道数据目錄

本示例使用 /data/zentao 作为新版禅道得持久化目錄，要保证 /data 分區或 / 分區有足夠的剩余空間。

mkdir /data/zentao

3.2.2 下載镜像，启动服務

禅道镜像内包含MySQL服務，默认不启动，如果启动内置的MySQL服務，需要設置環境變量 MYSQL_INTERNAL=true

拉取鏡像

docker pull hub.zentao.net/app/zentao:max4.5

啓動禅道

docker run -d \
--name new-zentao \
-v /data/zentao:/data \
-p 8080:80 \
-p 13306:3306 \
-e MYSQL_INTERNAL=true \
hub.zentao.net/app/zentao:max4.5

注意：

启动命令設置了 MYSQL_INTERNAL=true 環境變量，会在容器内启动MySQL服務

请根据实际情况設置容器名称，本示例使用 new-zentao 是为了与舊版的 zentao 名稱區分

请根据实际情况設置端口映射，本示例將容器内的80端口映射为8080，3306映射为13306

查看啓動日志

docker logs -f zentao

日志信息如下：

 14:18:19.19
 14:18:19.20 Welcome to the Easysoft ZenTao max4.5 container
 14:18:19.20 Subscribe to project updates by watching 
 14:18:19.20 Submit issues and feature requests at /ask.html
 14:18:19.20
 14:18:19.21 INFO  ==> Prepare persistence directories.
 14:18:19.46 INFO  ==> Render php.ini with environment variables.
 14:18:19.46 INFO  ==> render template php.ini for amd64
 14:18:19.47 INFO  ==> Render apache sites config with envionment variables.
 14:18:19.49 INFO  ==> Copy mysql data to /data/mysql/data
 14:18:19.49 INFO  ==> Check whether the MySQL is available.
 14:18:19.50 WARN  ==> Waiting MySQL 1 seconds
 14:18:19.51 WARN  ==> Please open the browser to complete the installation through the wizard.
 14:18:19.52 INFO  ==> Render mysql config with envionment variables.
230804 14:18:19 mysqld_safe Logging to '/data/mysql/logs/mysql_error.log'.
230804 14:18:19 mysqld_safe Starting mariadbd daemon with databases from /data/mysql/data
 14:18:20.51 INFO  ==> MySQL is ready.
 14:18:20.51 WARN  ==> Please open the browser to complete the installation through the wizard.

注意：

容器启动时会根据環境變量对PHP、Apache、MySQL等服務进行配置，支持的環境變量

容器启动时，会检查MySQL服務是否可以正常连接，默认情况下等待30秒，如果30秒内不能连接MySQL，容器会自动退出

首次啓動容器時，最後會打印輸出 Waiting for the installation wizard to complete. 看到这个消息，请打开浏覽器，完成禅道安裝向导。

3.3 导入備份的数据

在导入備份的数据之前，先要了解新版镜像的持久化目錄对应关系：

禅道代码目錄	容器持久化目錄	說明
/apps/zentao/www/data	/data/zentao/www/data	禅道用戶上传的文件目錄
/apps/zentao/config/my.php	/data/zentao/config/my.php	禅道主配置文件
/apps/zentao/config/ext	/data/zentao/config/ext	存放禅道插件的目錄
/apps/zentao/config/license	/data/zentao/config/license	禅道授權目錄
/apps/zentao/extension/custom	/data/zentao/extension/custom	禅道自定义插件目錄
/apps/zentao/module/extension/ext	/data/zentao/module/extension/ext	禅道企業版/旗艦版插件目錄
/apps/zentao/tmp/backup	/data/zentao/tmp/backup	備份目錄
/apps/zentao/tmp/log	/data/zentao/tmp/log	日志目錄
/apps/zentao/tmp/template	/data/zentao/tmp/template	模板目錄

注意：

为了实现以上目錄的持久化存储，新版禅道镜像对需要做持久化的目錄做了软连接处理，首次启动时会在 /data 创建目錄，并软连接到容器内的禅道代码目錄，详情参加：源码：持久化目錄处理

將舊版的備份恢复到新版的操作要尽量选用低峰，否则会造成数据不一致。

3.3.1 恢复文件

恢复文件时建议關閉新舊版的禅道服務，上文得到的舊版禅道目錄是 /tmp/zentao-files 因此，需要將该目錄下需要持久化的目錄复制到新版镜像持久化目錄即可，不需要將所有文件复制到新版持久化目錄。

# 關閉舊版禅道服務
docker stop zentao
# 關閉新版禅道服務
docker stop new-zentao
# 將舊版需要持久化的目錄复制到新版目錄
# 此步骤在宿主机執行
# www/data             -- 禅道用戶上传的文件目錄
cp -rp /tmp/zentao-files/www/data /data/zentao/www/
# config/my.php        -- 禅道主配置文件
cp -rp /tmp/zentao-files/config/my.php /data/zentao/config/my.php
# config/ext           -- 存放禅道插件的目錄
cp -rp /tmp/zentao-files/config/ext /data/zentao/config/
# config/license       -- 禅道授權目錄
cp -rp /tmp/zentao-files/config/license /data/zentao/config/
# extension/custom     -- 禅道自定义插件目錄
cp -rp /tmp/zentao-files/extension/custom /data/zentao/extension/
# module/extension/ext -- 禅道企業版/旗艦版插件目錄
[ -d /tmp/zentao-files/module/extension/ext ] && cp -rp /tmp/zentao-files/module/extension/ext /data/zentao/module/extension/

3.3.2 修改my.php配置

vi /data/zentao/config/my.php
<?php
$config->installed       = true;
$config->debug           = false;
$config->requestType     = 'PATH_INFO';
$config->timezone        = 'Asia/Shanghai';
$config->db->host        = '127.0.0.1';  # 使用内部的MySQL
$config->db->port        = '3306';
$config->db->name        = 'zentao';
$config->db->user        = 'root';
$config->db->encoding    = 'UTF8';
$config->db->password    = '123456';     # 默认密码
$config->db->prefix      = 'zt_';
$config->webRoot         = getWebRoot();
$config->default->lang   = 'zh-cn';

注意：

如果你之前使用的就是內置MySQL，且沒有修改過默認密碼，my.php 可以不用修改。

如果你修改了默認的數據庫密碼，請將MySQL的密碼修改爲更新後的密碼。

如果你使用的是外部的MySQL，my.php不需要修改。

3.3.3 恢复数据库

啓動新版禅道鏡像：

# 启动之前，先确认舊版禅道容器是否已经清理
docker rm zentao
# 启动新版禅道
docker run -d \
--name zentao \
-v /data/zentao:/data \
-p 8080:80 \
-p 13306:3306 \
-e MYSQL_INTERNAL=true \
hub.zentao.net/app/zentao:max4.5
# 查看服務状态
docker logs -f zentao

將 3.1 備份的数据库导入到新启动的MySQL：

# 删除備份文件的第一行 sed -i '1d' 202303150937474.sql.php # 將SQL中不符合时间规范的字段替换为 1970-01-01 sed -i 's/0000-00-00/1970-01-01/g' 202303150937474.sql.php # 修改文件名 mv 202303150937474.sql.php 202303150937474.sql # 导入数据，宿主机執行

mysql -uroot -h127.0.0.1 -P13306 -p zentao < 202303150937474.sql

# 导入数据完成后，手動重启zentao容器

docker restart zentao

四、新版禅道鏡像的版本升級

从舊版鏡像切换到新版镜像，或者直接使用新版镜像后，升级禅道只需要拉取最新的禅道镜像即可。

切记：升级前通过命令行或者禅道后台備份数据

本示例介绍如何从禅道旗艦版 4.5 升级到 4.6

# 拉取禅道旗艦版 4.6 的镜像
docker pull hub.zentao.net/app/zentao:max4.6

4.2 關閉舊版容器，启动新版镜像

# 關閉舊版容器
docker stop zentao
# 启动新版镜像
docker run -d \
--name zentao \
-v /data/zentao:/data \
-p 8080:80 \
-p 13306:3306 \
-e MYSQL_INTERNAL=true \
hub.zentao.net/app/zentao:max4.6

五、其他

5.1 將Session存儲到Redis

新版禅道镜像支持通过環境變量更改Session的存放类型，如下：

變量名	默認值	說明
PHP_SESSION_TYPE	files	php session 类型，files 或 redis
PHP_SESSION_PATH	/data/php/session	php session 存储路径

示例：

docker run -d \
--name zentao \
-v /data/zentao:/data \
-p 8080:80 \
-p 13306:3306 \
-e MYSQL_INTERNAL=true \
-e PHP_SESSION_TYPE=redis \
-e PHP_SESSION_PATH=tcp://192.168.1.88:6379 \
hub.zentao.net/app/zentao:max4.6

5.2 其他功能扩展

新版禅道镜像会针对禅道的功能增加不同的環境變量，通过環境變量开启和变更相关的功能与配置，更多详情参见：支持的環境變量

5.3 其他链接

新版禅道鏡像源碼
新版禅道镜像Docker hub地址
渠成在線安裝禅道
- 開源版
- 企業版
- 旗艦版

六、曆史記錄

V1.0

首版

V2.0

内置MySQL，默认情况下不启动，可以通过設置MYSQL_INTERNAL=true 啓用內置MySQL。
降低部署成本，运行方式与舊版保持一致，高级用戶可选择docker-compose的方式运行。
18.6 版本禅道镜像会同步更新国内镜像，以后会使用 hub.zentao.net 的域名，方便国内用戶拉取鏡像。
鏡像的運行時（Apache、PHP、MySQL）會按照官方的穩定版一起發布，可及時修複環境安全漏洞。
支持amd64与arm64 架构，满足国产信创需求。

禅道産品
禅道開源版禅道企業版禅道旗艦版禅道IPD版
核心功能
産品管理項目管理質量管理效能管理
使用文檔
基本版手冊企業版手册旗艦版手册 IPD版手冊開發中心手冊
幫助中心
积分問答常見問題論壇交流使用視頻 Gitee GitHub
關于我們
關于我們禅道軟件最新動態禅道活動
禅道社區
禅道博客積分排行積分商城禅道書院
聯系方式
聯系人：劉璐電話：18562550650 微信：18562550650 Q Q：2845263372
北京、上海、深圳分部

友情鏈接： ZTF自动化測試框架 ZenData測試数据生成器喧喧IM 敏捷開發敏捷咨詢測試窝悅庫網盤 Ledge知識平台渠成軟件 ZDOO全協同企業管理軟件融管理社區 ZenDAS數據分析工具 ZenShot跨平台截圖工具飛信釘即時通訊解決方案項目管理 IPD學習網 PMP百科網艾體驗創無記2049

午夜伧理A级日韩1片

本篇目錄

本篇目錄

一、爲什麽要升級？

二、新舊版本對比

三、舊版升級流程

3.1 備份数据

3.2 启动新版禅道镜像

3.2.1 创建新版禅道数据目錄

3.2.2 下載镜像，启动服務

3.3 导入備份的数据

3.3.1 恢复文件

3.3.2 修改my.php配置

3.3.3 恢复数据库

四、新版禅道鏡像的版本升級

4.2 關閉舊版容器，启动新版镜像

五、其他

5.1 將Session存儲到Redis

5.2 其他功能扩展

5.3 其他链接

六、曆史記錄

V1.0

V2.0

禅道産品

核心功能

使用文檔

幫助中心

關于我們

禅道社區

聯系方式

北京、上海、深圳分部