50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
# 6.16 定时任务管理
|
||
|
||
:::tip 概述
|
||
任务管理页（gin_job + gin_job_log）管理 cron 任务的定义与执行：新建、启停、手动执行、执行日志。调度机制详见 [5.19 定时任务调度机制](/zh/core/job-scheduler.html)。
|
||
:::
|
||
|
||
## 功能清单
|
||
|
||
### 任务（job）
|
||
|
||
| 接口 | 说明 |
|
||
|---|---|
|
||
| Page / List / Detail | 标准查询 |
|
||
| Add / Update / Delete / BatchDelete | 任务定义维护（url 字段 = 处理器注册名） |
|
||
| RunOnce | GET /api/job/runOnce/:id 立即执行一次（经执行锁防并发，权限码 sys:job:execute） |
|
||
| Pause / Resume | GET /api/job/pause/:id、resume/:id 暂停/恢复（cron 摘除/挂载） |
|
||
| Status | POST /api/job/status 设置任务状态 |
|
||
| DaemonStatus | GET /api/job/daemonStatus 调度器守护状态（登录即可，无需权限码） |
|
||
|
||
### 执行日志（job_log）
|
||
|
||
| 接口 | 说明 |
|
||
|---|---|
|
||
| Page / List / Detail | 执行记录查询 |
|
||
|
||
## 任务记录关键字段
|
||
|
||
| 字段 | 语义 |
|
||
|---|---|
|
||
| url | 处理器注册名（与 internal/task 的 RegisterJobHandler 名一致，**数据驱动查找**） |
|
||
| cron_expression | cron 表达式（或 @every 描述符） |
|
||
| execute_policy | 执行策略：1-立即执行 2-执行一次 3-放弃执行（字典 job_execute_policy 回填显示名） |
|
||
| is_sync | 是否同步执行：0-否 1-是（字典 job_is_sync） |
|
||
| params | 任务参数（JSON 字符串，传给处理器） |
|
||
| status | 启停状态（字典 job_status） |
|
||
|
||
url 与处理器注册名不匹配时任务无法执行——新建任务前确认处理器已注册（内置：LogClean / SendSms / HelloWorld）。
|
||
|
||
## 执行可靠性
|
||
|
||
执行锁（`job.lockTTLSeconds`，执行期自动续期）+ 任务日志（开始/结束/耗时/结果摘要）。
|
||
|
||
## 管理界面
|
||
|
||
`monitor/job`：任务列表 + 执行日志页签 + 手动执行/启停按钮。
|
||
|
||
## 相关
|
||
|
||
- [5.19 定时任务调度机制](/zh/core/job-scheduler.html)
|