mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-16 22:12:01 +00:00
a2a19df9df
- 表:schedules(Webhook 地址和签名密钥加密存放、next_run_at 存 UTC、version 乐观锁)、schedule_fires((任务,
fire_at, kind) 唯一)、webhook_deliveries;新表由 create_all 建,不用迁移
- 输入模板:{{ schedule.yesterday }} 这类变量按计划触发时间在任务时区算(不按「现在」:补发晚了、零点前后立即
运行,「昨天」都是那次触发的昨天),上一次计划触发时间按 cron 往前找,同一次触发永远渲染出同一份输入;未知
变量、未知过滤器、{{ }} 不成对都拦下,声明了入口字段的工作流还对照字段名和必填项
- 调度循环:每 15 秒一拍,条件 UPDATE 认领到点的任务并推进到下一次,两拍并发只有一拍认领得到,触发记录的唯一
约束是第二道保险;上一次运行没结束(含停在审批、服务重启挂起的)记跳过;错过的只看最近一次,在宽限内补一次、
超出记跳过,积压不补;发起走 launch_run,拒绝的原话记成未能发起,别的异常记通用说明、详情进日志;stop 等手上
这一拍收尾,开关关着时 start 不起循环
- Webhook:通用 JSON(可选 HMAC 签名头)、飞书文本、企业微信 markdown、钉钉 markdown,按各平台算法签名;运行
结束、失败、确有待审批时按订阅推一次,结束的等封存好再推,没订阅、没配 Webhook 的也记下已处理,之后配上不会
补推旧的;10 秒超时、失败重试 3 次(4xx 不重试),每次推送记一条记录;通知里没有报告数字和原始报错,日志和
错误里只有主机名(httpx 自己的请求日志也换成主机名)
- 设置 notify.public_base_url:通知里的运行链接 = 它 + /runs/{id},只收 http(s) 地址,末尾的 / 去掉
50 lines
2.1 KiB
Python
50 lines
2.1 KiB
Python
"""定时任务的后台调度:到点按定时任务的设置发起工作流运行,结束、失败、停在审批时推送 Webhook。
|
|
|
|
- cron.py:五字段 cron 的解析、下次触发、中文描述
|
|
- service.py:输入模板、和工作流入口字段的对照、发起一次触发(调度循环和「立即运行」共用)
|
|
- loop.py:调度循环,条件 UPDATE 认领到点的任务
|
|
- webhook.py:通知推送(通用 / 飞书 / 企业微信 / 钉钉)
|
|
|
|
服务启动时(main.py 的 lifespan)只在 scheduler_enabled() 时调 start,关闭时总是调 stop——stop 要能在没 start
|
|
过时安全返回。start 自己也看一次开关:拷来的数据目录(检查脚本的 --stacks、验收副本)不管从哪条路径起服务,
|
|
都不会替原库把定时任务再执行一遍。
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
|
|
from app.core.config import Settings, settings
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
def scheduler_enabled(config: Settings | None = None) -> bool:
|
|
"""调度循环开不开:AGENTLAB_SCHEDULER,默认开,0 / false / off 关(见 core/config.py)。
|
|
|
|
config 只给测试用:settings 是模块级单例,改环境变量不会让它重读。"""
|
|
return bool((config or settings).scheduler)
|
|
|
|
|
|
async def start(*, interval: float | None = None, config: Settings | None = None) -> bool:
|
|
"""起调度循环,返回起没起。开关关着时什么都不做;已经在跑时不起第二个。interval 只给测试用。"""
|
|
if not scheduler_enabled(config):
|
|
logger.info("定时任务调度已关闭(AGENTLAB_SCHEDULER),不会自动发起运行")
|
|
return False
|
|
from app.scheduler.loop import TICK_SECONDS, runner
|
|
|
|
await runner.start(interval if interval is not None else TICK_SECONDS)
|
|
return True
|
|
|
|
|
|
async def stop() -> None:
|
|
"""停调度循环,等手上的那一轮收尾。没 start 过也能安全调用。"""
|
|
from app.scheduler.loop import runner
|
|
|
|
await runner.stop()
|
|
|
|
|
|
def running() -> bool:
|
|
from app.scheduler.loop import runner
|
|
|
|
return runner.running()
|