禅道定时任务配置教程详解

需配置系统crond服务、禅道后台定时任务、自定义crontab、Roadrunner服务并验证执行效果，才能实现禅道数据备份、索引重建、邮件发送等操作的全自动定时运行。

如果您希望禅道系统中的数据备份、索引重建、邮件发送等操作无需人工干预即可按固定时间自动运行，则需正确配置计划任务机制。以下是实现禅道定时任务自动执行的具体步骤：

一、启用并启动系统级crond服务

禅道的定时任务底层依赖Linux系统的crond守护进程，该服务负责按设定时间触发脚本或命令。若未启用，所有定时任务将无法被调度执行。

1、检查crond服务是否已安装：rpm -q crontabs

2、如未安装，执行：yum install crontabs -y

3、设置开机自启：systemctl enable crond

4、立即启动服务：systemctl start crond

5、验证运行状态：systemctl status crond（应显示 active (running)）

二、通过禅道后台界面配置内置定时任务

禅道自v18.9起提供图形化定时任务管理入口，适用于常规操作如备份、发信、清理回收站等，无需手动编辑系统crontab。

1、使用管理员账号登录禅道后台

2、点击左侧菜单栏“后台” → “系统” → “定时”

3、在“内置任务”列表中，找到目标任务（如“备份数据库”、“发送待办邮件”、“清理回收站”）

4、点击对应行右侧的“启用”开关

5、点击“编辑”按钮，设置执行周期（支持分钟/小时/日/周/月五级粒度）

6、保存后，任务即加入禅道内部调度队列，由Roadrunner或PHP CLI进程接管执行

三、手动添加系统级crontab条目

当需要执行自定义脚本（如远程备份、SVN同步、日志归档）时，必须直接写入/etc/crontab或用户crontab，绕过禅道后台界面限制。

1、以root身份编辑系统crontab：vim /etc/crontab

2、在文件末尾新增一行，格式为：分 时 日 月 周 用户名 命令

3、例如每天凌晨2:30执行禅道备份脚本：30 2 * * * root /opt/zentao_cp.sh

4、确保脚本具备可执行权限：chmod +x /opt/zentao_cp.sh

5、重载crond配置（部分系统需执行）：systemctl reload crond

四、部署Roadrunner服务提升任务稳定性

禅道v18.9+默认启用Roadrunner替代传统PHP CLI子进程执行耗时任务，避免超时中断、内存泄漏及Web请求阻塞问题。

1、确认禅道版本是否≥18.9：cat /zentao/version.php | grep 'version'

2、下载Roadrunner二进制文件：curl -skL https://github.com/roadrunner-server/roadrunner/releases/download/v2023.3.5/roadrunner-2023.3.5-linux-amd64.tar.gz | tar xvz -C /tmp/

3、移动至系统路径：mv /tmp/roadrunner-2023.3.5-linux-amd64/rr /usr/local/bin/

4、验证安装：rr -v（应输出版本号与GO构建信息）

5、启动Roadrunner服务：/usr/local/bin/rr serve -c /zentao/conf/roadrunner.yaml

6、检查进程：ps aux | grep rr（应看到4个PHP工作进程）

五、验证定时任务实际执行效果

仅配置完成不等于任务已生效，必须通过日志与结果双重确认其真实运行状态。

1、查看系统crond日志：tail -f /var/log/cron

2、检查禅道任务执行记录：cat /zentao/tmp/logs/schedule.log

3、进入禅道后台“后台” → “系统” → “定时” → “执行记录”页签

4、确认目标任务的“最后执行时间”与“状态”字段更新为最近时间且显示“成功”

5、对备份类任务，手动检查目标目录下是否生成带日期时间戳的.tar.gz文件