定时调度
调度启动本地同步 Task 命令。应用计算后续触发时点,Daemon 拥有已经启动的进程。
图中右上方是定时执行路径:App Cron 计算触发时间,Daemon 拥有已启动的命令。它与两种手动路径共用 Task 运行时。
最小配置
extends: default
timezone: Asia/Shanghai
cron:
- expression: "0 16 * * 1-5"
command:
- axonx exec --task download_tushare_task
- --days-back 7使用 axonx app --config scheduled.yaml 启动。cron: [] 关闭继承计划;列表整体替换父列表,配置变化后重启。
Cron 与时区
表达式恰好五个数字字段:分、时、日、月、星期。支持数字范围、列表、步长和通配符,拒绝星期名称和秒字段。触发使用应用时区。到期条目触发一次,然后从当前时间推进,不补跑错过时点。
命令参数
command 是一个字符串,或用空格拼成同一条命令的字符串片段列表。长片段可用 YAML >- 块换行。包含空格的值和 JSON 参数须保留命令内的引号,锚点可复用完整的带引号参数片段。列表每项都必须是字符串。
命令必须以 axonx exec 开始并包含非空 --task NAME。通过 shlex 解析,不经过 shell,不支持管道、重定向、环境赋值或 --target 等客户端选项。执行默认值和环境配置在应用层,也可显式传入 Task 执行字段。
并发与身份
调度不提供命名计划记录、并发策略或自动 skip/replace 队列。一次触发请求启动一个 Daemon 命令。自动生成的任务名称保留独立记录;固定 --task-name 复用目录,需要调用方协调,旧同名执行仍在运行时会拒绝启动。业务重叠策略应在 Task 或宿主集成中显式实现。
检查与关闭
检查 Daemon/服务日志和 logs/cron/entry-N.log,再检查 Task metadata 和产物。启动进程不代表成功。关闭应用停止后续触发;Daemon 已启动的定时执行在应用服务重启后继续,服务拥有的手动 CLI 命令则随服务关闭而停止。定时进程仍活动时更新源码或依赖需要协调,因为进程不固定代码版本。
嵌入式应用
Application(cron=..., launch_scheduled=callback) 要求宿主提供启动器。回调接收条目索引和 CronConfig,进程生命周期归宿主管理。CLI 启动注入 Daemon 启动器,详见框架扩展。
源码:CronConfig、触发循环、Daemon 启动器。
定时 Job
使用 backend: scheduled 在服务内按日历时刻运行 pipeline:
jobs:
hourly_diagnostics:
backend: scheduled
expression: "0 * * * *"
arguments: {}
enable_serve: false
steps:
- backend: diagnose_stepexpression 与 Cron 共用五字段数字表达式和 App 时区。可选 arguments 提供定时调用的公共入参,必须满足 parameters;defaults 继续提供 pipeline 上下文默认值。Steps 和普通 Job 生命周期直接复用。enable_serve: false 只隐藏 HTTP/MCP 入口,不停用调度。
整个应用启动完成后才接受定时调用,调用结束后再计算下一次触发时刻,不补跑错过的时刻,定时调用之间不会重叠。失败会记日志,之后仍继续调度;维护期间跳过新调用,服务停止时取消当前调用及其自有工作。启动时不重放历史触发。如果同时开放服务入口,手动调用仍遵循普通 pipeline 并发行为。