Cron Triggers 配置说明

# Cron 触发器配置 ## wrangler.jsonc c { "$schema": "./node_modules/wrangler/config-schema.json", "name": "my-cron-worker", "main": "src/index.ts", "compatibility_date": "2025-01-01", // 新项目请使用当前日期 "triggers": { "crons": [ "*/5 * * * *", // 每 5 分钟 "0 */2 * * *", // 每 2 小时 "0 9 * * MON-FRI", // 工作日 UTC 时间上午 9 点 "0 2 1 * *" // 每月 1 号 UTC 时间凌晨 2 点 ] } } ## 绿色计算 (Beta) 在低碳排放时段调度 cron 任务，实现碳感知执行： c { "name": "eco-cron-worker", "triggers": { "crons": ["0 2 * * *"] }, "placement": { "mode": "smart" // 在低碳排放时段运行 } } **模式:** - `"smart"` - 碳感知调度（可能会延迟最多 24 小时以寻找最佳时段） - 默认（无 placement 配置） - 标准调度（无延迟） **工作原理:** - Cloudflare 会延迟执行，直到电网碳强度降低 - 最大延迟：从预定时间起 24 小时 - 非常适合时间要求灵活的批处理作业 **适用场景:** - 夜间数据处理和 ETL 管道 - 每周/每月报告生成 - 数据库备份和维护 - 分析聚合 - 机器学习模型训练 **不适用场景:** - 时间敏感的操作（有 SLA 要求） - 需要立即执行的用户侧功能 - 实时监控和告警 - 有严格时间窗口的合规性任务 ## 环境特定调度 c { "name": "my-cron-worker", "triggers": { "crons": ["0 */6 * * *"] // 生产环境：每 6 小时 }, "env": { "staging": { "triggers": { "crons": ["*/15 * * * *"] // 测试环境：每 15 分钟 } }, "dev": { "triggers": { "crons": ["*/5 * * * *"] // 开发环境：每 5 分钟 } } } } ## 调度格式 **结构:** `分钟 小时 月份中的日期 月份 星期几` **特殊字符:** `*` (任意), `,` (列表), `-` (范围), `/` (步长), `L` (最后), `W` (工作日), `#` (第几个) ## 管理触发器 **移除所有:** `"triggers": { "crons": [] }` **保留现有:** 完全省略 `"triggers"` 字段 ## 部署 bash # 使用配置的 crons 进行部署 npx wrangler deploy # 部署特定环境 npx wrangler deploy --env production # 查看部署列表 npx wrangler deployments list **⚠️ 更改在全球范围内生效最多需要 15 分钟** ## API 管理 **获取触发器:** bash curl "https://api.cloudflare.c