![](/theme/default/default/images/main/icon-menu.png)
升级禅道新版本
手册分类
![](/theme/default/default/images/main/icon-close-2x.png)
![](https://cdn.easycorp.cn/web/data/upload/zentao/202402/f_0c7d40c83be2425f404dc4bd5ee778cb.png)
- 1. 禅道介绍
- 1.1 关于禅道项目管理软件
- 1.2 如何获得支持
- 1.3 各版本功能差异
- 1.4 关注我们
- 2. 安装禅道
- 2.1. 环境搭建
- 2.1.1 搭建Ubuntu环境安装禅道
- 2.1.2 搭建Centos环境安装禅道
- 2.1.3 安装PHP的ioncube扩展
- 2.2. 安装禅道新版本
- 2.2.1 选择适合您的安装方法
- 2.2.2 新版本禅道的安装升级
- 2.2.3 Windows一键安装包(新版)
- 2.2.4 Windows一键安装包(旧版)
- 2.2.5 linux用一键安装包(推荐)
- 2.2.6 使用源码包安装(各系统通用)
- 2.2.7 使用源码包安装(MAC系统)
- 2.2.8 基于禅道当前的一键安装包(Windows和Linux)如何源码安装旗舰版禅道
- 2.2.9 渠成命令行安装禅道
- 2.2.10 Docker和Kubernetes方式部署禅道
- 2.3. 安装12开源版
- 2.3.1 选择适合您的安装方法
- 2.3.2 使用云禅道在线项目管理服务
- 2.3.3 (推荐)windows用一键安装包安装
- 2.3.4 (推荐)Linux用一键安装包
- 2.3.5 linux下用lampp集成包安装
- 2.3.6 使用源码包安装(MAC系统)
- 2.3.7 MAC下用XAMPP安装禅道
- 2.3.8 MAC下用XAMPP-VM安装禅道
- 2.3.9 使用源码包安装(各系统通用)
- 2.3.10 宝塔面板安装禅道
- 2.3.11 华芸NAS在线安装
- 2.3.12 Centos7.4系统下安装httpd,mariadb,php7.2环境运行禅道
- 2.3.13 Centos8系统下安装httpd,mariadb,php7.2环境运行禅道
- 2.3.14 安装ioncube扩展
- 2.3.15 安装swoole扩展
- 2.3.16 Docker方式部署禅道
- 2.4. 安装12企业版
- 2.4.1 禅道企业版安装包安装方式(各系统通用)
- 2.4.2 (推荐)Windows一键安装包安装
- 2.4.3 (推荐)Linux一键安装包安装
- 2.4.4 centos 7.x 源码安装禅道企业版
- 2.5 安装PHP的LDAP扩展
- 2.6 在线安装云禅道
- 2.7 安装 APCu扩展
- 2.8 安装DuckDB引擎
- 2.1. 环境搭建
- 3. 升级禅道
- 3.1. 升级12开源版
- 3.1.1 选择和自己环境对应的升级方式
- 3.1.2 通过源代码方式升级(通用)
- 3.1.3 windows一键安装包的升级
- 3.1.4 linux一键安装包升级
- 3.2. 升级12企业版
- 3.3. 升级禅道新版本
- 3.3.1 选择和自己环境对应的升级方式
- 3.3.2 通过源代码方式升级(通用)
- 3.3.3 windows一键安装包的升级
- 3.3.4 linux一键安装包升级
- 3.3.5 docker安装禅道-升级禅道
- 3.3.6 旧版Docker镜像升级说明
- 3.3.7 通过Roadrunner管理定时任务
- 3.4 如何安装ioncube扩展
- 3.1. 升级12开源版
- 4. 维护配置
- 4.1. 维护禅道
- 4.1.1 初始化管理脚本
- 4.1.2 备份禅道
- 4.1.3 恢复删除的资源
- 4.1.4 如何更新燃尽图
- 4.1.5 一键安装包如何实现mysql异机连接
- 4.1.6 linux一键安装包配置https
- 4.2. 配置禅道
- 4.2.1 设置是否允许匿名访问
- 4.2.2 如何配置email发信
- 4.2.3 如何成为超级管理员
- 4.2.4 配置禅道系统为静态访问
- 4.2.5 去掉禅道访问地址中的zentao
- 4.2.6 linux一键安装包去掉禅道访问地址中的zentao
- 4.2.7 集成禅道和svn
- 4.2.8 集成禅道和git
- 4.2.9 在第三方应用中集成禅道
- 4.2.10 第三方应用配置免密登录禅道
- 4.2.11 第三方应用集成禅道客户端进行消息通知
- 4.2.12 集成webhook
- 4.2.13 集成ZDOO
- 4.2.14 客户端集成
- 4.2.15 禅道的翻译功能
- 4.2.16 浏览器通知的设置
- 4.2.17 集成钉钉工作消息通知
- 4.2.18 集成企业微信应用消息通知
- 4.2.19 集成飞书群机器人
- 4.2.20 集成飞书消息通知
- 4.2.21 集成版本库、集成Jenkins,并进行构建
- 4.2.22 解决一键安装包密码口令弱的问题
- 4.3. 性能优化
- 4.1. 维护禅道
- 5. 快速入门
- 5.1. 12版本快速入门
- 5.1.1 禅道使用的基本流程和产品、研发、测试之间的三权分立
- 5.1.2 禅道的新手教程
- 5.1.3 创建第一个产品
- 5.1.4 添加第一个需求
- 5.1.5 开始第一个项目
- 5.1.6 确定项目要完成的需求列表
- 5.1.7 为需求分解任务
- 5.1.8 提交bug
- 5.1.9 禅道的自定义功能
- 5.1.10 文档管理
- 5.1.11 如何排查产品、项目是否有访问权限
- 5.1.12 年度总结,工作内容统计一览表说明
- 5.2. 12版创建分组和用户
- 5.2.1 建立部门结构
- 5.2.2 添加一个用户帐号
- 5.2.3 批量维护帐号
- 5.2.4 设置分组,建立权限体系
- 5.3. 12版本最简使用
- 5.3.1 使用禅道来进行项目任务管理
- 5.3.2 只使用禅道来做bug管理
- 5.3.3 只使用禅道来进行产品管理
- 5.3.4 个人使用禅道来做事务跟踪管理
- 5.4. 12版本基本使用
- 5.4.1 敏捷开发及scrum简介
- 5.4.2 禅道和scrum的对应关系
- 5.4.3 视频教程:第一个演示项目
- 5.4.4 维护联系人
- 5.4.5 导入excel、csv参考文档
- 5.4.6 工作方式的切换
- 5.4.7 操作获取积分功能
- 5.4.8 自定义必填项功能
- 5.5. 12版本进阶使用
- 5.5.1. 使用流程
- 5.5.1.1 禅道使用流程图解
- 5.5.2. 个人管理
- 5.5.2.1 使用待办进行个人事务管理
- 5.5.2.2 关注需要自己处理的任务、需求、bug
- 5.5.2.3 通过我的档案查看或者修改个人信息
- 5.5.2.4 视频教程:禅道使用之个人篇
- 5.5.3. 产品经理篇
- 5.5.3.1 维护产品
- 5.5.3.2 维护产品线
- 5.5.3.3 创建和评审需求
- 5.5.3.4 变更和评审需求
- 5.5.3.5 需求的状态和研发阶段
- 5.5.3.6 需求的注意事项
- 5.5.3.7 维护产品模块
- 5.5.3.8 建立发布计划
- 5.5.3.9 建立发布
- 5.5.3.10 路线图
- 5.5.3.11 文档管理
- 5.5.3.12 主持产品会议
- 5.5.3.13 参与项目管理、演示和总结
- 5.5.3.14 需求的基本统计报表
- 5.5.3.15 视频教程:禅道使用之产品经理篇
- 5.5.4. 项目经理篇
- 5.5.4.1 建立项目
- 5.5.4.2 组建项目团队
- 5.5.4.3 确定项目要完成的需求列表
- 5.5.4.4 组织进行任务分解
- 5.5.4.5 召开每天的站立会议
- 5.5.4.6 通过燃尽图了解项目的进展
- 5.5.4.7 通过各种列表的各种功能了解项目进展
- 5.5.4.8 召开演示会议和总结会议
- 5.5.4.9 项目任务基本的报表统计
- 5.5.4.10 视频教程:禅道使用之项目经理篇
- 5.5.5. 开发团队篇
- 5.5.5.1 参加项目计划会议,分解任务
- 5.5.5.2 领取任务,并每天更新任务
- 5.5.5.3 通过看板和树状图查看任务
- 5.5.5.4 创建版本
- 5.5.5.5 申请测试
- 5.5.5.6 解决bug
- 5.5.5.7 文档管理
- 5.5.5.8 确认bug
- 5.5.5.9 视频教程:禅道使用之开发团队篇
- 5.5.6. 测试团队篇
- 5.5.6.1 维护bug视图模块
- 5.5.6.2 提交bug
- 5.5.6.3 验证bug,关闭
- 5.5.6.4 激活bug
- 5.5.6.5 找到自己需要的bug
- 5.5.6.6 维护测试用例视图
- 5.5.6.7 创建测试用例
- 5.5.6.8 测试套件、报告和公共用例库的维护
- 5.5.6.9 管理测试版本
- 5.5.6.10 执行用例,提交Bug
- 5.5.6.11 查看报表统计
- 5.5.6.12 视频教程:禅道使用之测试团队篇
- 5.5.1. 使用流程
- 5.6. 12版本企业版使用
- 5.6.1 开源版功能
- 5.6.2 添加用户和权限维护
- 5.6.3 甘特图功能简介
- 5.6.4 工作日志管理功能简介
- 5.6.5 代码库(SVN GIT)及代码评审
- 5.6.6 日历功能简介
- 5.6.7 Excel导入导出功能简介
- 5.6.8 短信通知功能简介
- 5.6.9 运维管理
- 5.6.10 导出为Word功能简介
- 5.6.11 水晶报表(自定义报表)功能简介
- 5.6.12 LDAP用户验证功能简介
- 5.6.13 反馈管理
- 5.6.14 统计视图功能简介
- 5.6.15 文档管理
- 5.6.16 报表导出功能简介
- 5.6.17. 办公管理
- 5.6.18. 工作流
- 5.6.18.1 工作流内置流程
- 5.6.18.2 工作流功能简介
- 5.6.18.3 自定义内置工作流
- 5.6.18.4 新增工作流示例
- 5.6.18.5 工作流 JS、CSS 使用说明
- 5.6.19 视频及PPT资料
- 5.7. 新版本快速入门
- 5.7.1 15后新版本禅道的新增功能
- 5.7.2 15后新版本禅道的界面变化
- 5.7.3 15后新版本禅道的最简使用
- 5.1. 12版本快速入门
- 6. 按照角色使用
- 6.1. 管理员
- 6.1.1 维护组织部门
- 6.1.2 维护用户
- 6.1.3 维护权限
- 6.1.4. 办公管理(企业版)
- 6.1.5. 工作流(企业版)
- 6.1.5.1 内置工作流(企业版)
- 6.1.6 短信通知(企业版)
- 6.1.7. 运维管理(企业版)
- 6.1.7.1 ZAgent的使用(企业版)
- 6.1.7.2 虚拟机的使用
- 6.1.8 LDAP用户验证(企业版)
- 6.2. 项目集负责人
- 6.3. 产品经理
- 6.4. 项目经理
- 6.4.1 维护项目和执行
- 6.4.2 维护团队
- 6.4.3 关联需求
- 6.4.4 分解任务
- 6.4.5 跟踪进度
- 6.4.6 甘特图(企业版)
- 6.4.7 代码评审(企业版)
- 6.4.8 瀑布项目的使用
- 6.4.9. 瀑布项目特有功能(旗舰版)
- 6.4.9.1 维护项目的计划、阶段(旗舰版)
- 6.4.9.2 项目设计、矩阵(旗舰版)
- 6.4.9.3 项目评审、配置(旗舰版)
- 6.4.9.4 项目报告、挣值管理(旗舰版)
- 6.4.9.5 项目调研、估算(旗舰版)
- 6.4.9.6 项目问题、风险、机会(旗舰版)
- 6.4.9.7 项目过程、度量、QA(旗舰版)
- 6.4.9.8 项目培训、会议(旗舰版)
- 6.4.10 看板项目的使用
- 6.4.11 融合敏捷项目
- 6.4.12 融合瀑布项目
- 6.4.13 文档管理(企业版)
- 6.4.14 Excel 导入导出(企业版)
- 6.4.15 Word 导出(企业版)
- 6.4.16 统计(企业版)
- 6.4.17 报表导出(企业版)
- 6.4.18 资产库管理
- 6.5. 研发人员
- 6.5.1 参加产品计划会议,分解任务
- 6.5.2 领取任务,并每天更新任务
- 6.5.3 创建版本,提交测试
- 6.5.4 确认Bug,解决Bug
- 6.5.5 执行的综合、需求、Bug、任务看板
- 6.6. 测试人员
- 6.1. 管理员
- 7. 功能介绍
- 7.1. 新增概念
- 7.1.1 项目集(Program)
- 7.1.2 项目(Project)
- 7.1.3 产品(Product)
- 7.1.4 管理模型
- 7.2. 地盘
- 7.3. 项目集
- 7.4. 产品
- 7.4.1 创建产品
- 7.4.2 维护模块
- 7.4.3 产品多分支/平台管理
- 7.4.4 维护计划
- 7.4.5 维护需求
- 7.4.6 需求的评审
- 7.4.7 创建发布
- 7.4.8 跟踪进度
- 7.4.9 业务需求&需求多层级
- 7.5. 项目
- 7.5.1. 项目通用功能
- 7.5.1.1 项目的基本设置
- 7.5.1.2 维护项目的执行
- 7.5.1.3 维护项目的需求
- 7.5.1.4 维护项目的Bug、用例、测试单、测试报告
- 7.5.1.5 维护项目的文档
- 7.5.1.6 维护项目的版本、发布
- 7.5.2 看板项目
- 7.5.3. 瀑布项目特有功能(企业版与旗舰版)
- 7.5.3.1 维护项目的计划、阶段
- 7.5.3.2 项目设计、矩阵(矩阵为旗舰版)
- 7.5.3.3 项目评审、配置(旗舰版)
- 7.5.3.4 项目报告、挣值管理(旗舰版)
- 7.5.3.5 项目调研、估算(旗舰版)
- 7.5.3.6 项目问题、风险、机会(旗舰版)
- 7.5.3.7 项目过程、度量、QA(旗舰版)
- 7.5.3.8 项目培训、会议(旗舰版)
- 7.5.4 融合敏捷项目
- 7.5.5 融合瀑布项目
- 7.5.6 项目资源日历(插件)
- 7.5.1. 项目通用功能
- 7.6. 执行
- 7.6.1 参加产品计划会议,分解任务
- 7.6.2 领取任务,并每天更新任务
- 7.6.3 创建版本,提交测试
- 7.6.4 确认Bug,解决Bug
- 7.6.5 执行的综合、需求、Bug、任务看板
- 7.7. 测试
- 7.8. 自动化测试
- 7.9 DevOps(新平台版)
- 7.10. DevOps(旧版)
- 7.10.1. DevOps 功能
- 7.10.1.1 Git/SVN版本库管理和查看代码
- 7.10.1.2. 集成GitLab
- 7.10.1.2.1 绑定用户,关联issue,进行构建
- 7.10.1.2.2 合并请求
- 7.10.1.2.3 禅道中GitLab的权限
- 7.10.1.3 集成Jenkins,进行构建
- 7.10.1.4 集成SonarQube
- 7.10.1. DevOps 功能
- 7.11. 看板
- 7.11.1 通用看板功能
- 7.12. 资产库(旗舰版)
- 7.12.1 资产库管理(旗舰版)
- 7.13. 文档
- 7.14. BI
- 7.14.1 维度(企业版8.4+)
- 7.14.2 大屏(企业版8.4+)
- 7.14.3. 大屏设计器
- 7.14.3.1 大屏设计器界面布局
- 7.14.3.2 大屏设计器引用图表
- 7.14.3.3 大屏设计器引用透视表
- 7.14.4 透视表(企业版8.4+)
- 7.14.5 透视表(企业版10.2+)
- 7.14.6 图表(企业版8.4+)
- 7.14.7 数据表(企业版8.4+)
- 7.14.8. 度量项
- 7.14.8.1 查看度量项
- 7.14.8.2 度量项编码开发操作手册
- 7.14.9 统计(旧版)
- 7.14.10 报表导出(旧版)
- 7.14.11 自定义报表(旧版)
- 7.14.12 可视化(旧版)
- 7.15. AI
- 7.15.1 AI小程序简介
- 7.15.2 创建与设计AI小程序(企业版)
- 7.15.3 调试AI小程序(企业版)
- 7.15.4 发布与禁用小程序
- 7.15.5 前台小程序的应用
- 7.15.6 AI小程序的导入导出
- 7.15.7 管理AI小程序权限
- 7.16. 组织
- 7.16.1 团队成员和工作信息
- 7.16.2 人力资源日历(需安装插件)
- 7.16.3 组织动态
- 7.16.4 公司信息
- 7.17. 办公(企业版)
- 7.18. 反馈(企业版)
- 7.19. 学堂(企业版)
- 7.19.1 学堂的课程和后台(企业版)
- 7.19.2 实践库(企业版)
- 7.20. 工作流(企业版)
- 7.20.1 内置工作流(企业版)
- 7.21. 后台设置
- 7.21.1 首页
- 7.21.2. 系统设置
- 7.21.2.1 模式、备份、回收站
- 7.21.2.2 聊天
- 7.21.2.3 授权、安全、定时、时区、重建索引、表引擎
- 7.21.2.4 LDAP(企业版)
- 7.21.3 功能开关(超级管理员)
- 7.21.4. 人员管理
- 7.21.5 模型配置
- 7.21.6. 功能配置
- 7.21.6.1 地盘、产品、执行、测试、看板、文档、反馈
- 7.21.6.2 审批、度量、用户、会议室
- 7.21.6.3 审批流程(旗舰版)
- 7.21.6.4 审批流程(旗舰版5.1)
- 7.21.7 文档模板(旗舰版)
- 7.21.8. 通知设置
- 7.21.9 插件管理
- 7.21.10 二次开发
- 7.21.11 数据导入(管理员)
- 7.21.12. 权限维护和控制
- 7.21.12.1 项目集的权限维护和访问控制
- 7.21.12.2 产品的权限维护和访问控制
- 7.21.12.3 项目的权限维护和访问控制
- 7.21.12.4 执行的权限维护和访问控制
- 7.21.12.5 项目和执行的访问控制和数据关系
- 7.21.13. AI配置
- 7.21.14. DevOps设置
- 7.22. 客户端增强版会议SRS
- 7.22.1. 音视频会议配置
- 7.22.1.1 安装音视频服务端
- 7.22.1.2 安装SRS音视频服务端
- 7.22.1.3 开启和配置音视频功能
- 7.22.2. 发起会议
- 7.22.2.1 一对一会话中发起音视频会议
- 7.22.2.2 群组会话中发起音视频会议
- 7.22.2.3 独立发起音视频会议入口
- 7.22.3. 加入会议
- 7.22.3.1 分享音视频会议到会话
- 7.22.3.2 通过会议的ID加入会议
- 7.22.4. 预约会议
- 7.22.4.1 预约会议
- 7.22.5. 会议应用
- 7.22.5.1 音视频会议应用
- 7.22.1. 音视频会议配置
- 7.23. 客户端增强版会议Jitsi
- 7.1. 新增概念
- 8. 其他相关
旧版Docker镜像升级说明 分享链接
作者:zhouyq
最后编辑:禅道-李锡碧 于 2024-04-01 09:39:46
浏览量:15394
一、为什么要升级?
- 优化更新流程,不需要下载安装包,直接拉取新版镜像即可
- 新版可以通过环境变量选择是否启用内置MySQL,方便对接外部MySQL
- 新版原生支持Kubernetes部署
- 旧版镜像2023年8月底停止更新
二、新旧版本对比
对比项 | 旧版 | 新版 | 说明 |
---|---|---|---|
镜像大小 | 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服务 | 手动 | 环境变量 |
三、旧版升级流程
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 https://www.zentao.net
14:18:19.20 Submit issues and feature requests at https://www.zentao.net/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 其他链接
-
渠成在线安装禅道
六、历史记录
V1.0
- 首版
V2.0
- 内置MySQL,默认情况下不启动,可以通过设置
MYSQL_INTERNAL=true
启用内置MySQL。 - 降低部署成本,运行方式与旧版保持一致,高级用户可选择docker-compose的方式运行。
- 18.6 版本禅道镜像会同步更新国内镜像,以后会使用 hub.zentao.net 的域名,方便国内用户拉取镜像。
- 镜像的运行时(Apache、PHP、MySQL)会按照官方的稳定版一起发布,可及时修复环境安全漏洞。
- 支持amd64与arm64 架构,满足国产信创需求。