浏览文档目录 +

服务 · Free / Go

定时任务

自动执行常见容器和镜像维护工作,并保留可追溯的运行历史。

定时任务真实界面,敏感信息已打码
真实产品界面 · 敏感信息已打码

可以做什么

  • 使用 cron 创建和维护计划
  • 启停任务或立即执行一次
  • 查看执行历史和失败原因

这个页面解决什么问题

定时任务页把“每天凌晨清理构建缓存”“每周检测镜像更新”这类重复运维交给 Client 后端按时执行。任务类型覆盖容器启动、停止、重启、镜像更新检测和构建缓存清理,全部在后端调度运行,页面关闭不影响执行。

它管理的是计划本身:每个任务有名称、类型、目标、Cron 表达式、启停状态和执行历史;Cron 的下次执行时间由后端计算并预览,前端不自行模拟调度器,看到的计划与真实调度一致。

执行历史是审计数据:每条记录显示时间与状态,成功为绿色、失败为红色、禁用为中性;删除任务不会隐式删除历史日志。

开始前准备

  • 容器类任务需要目标容器存在;容器删除后任务仍在,但执行会失败并记录在历史中。
  • 镜像更新检测与构建缓存清理作用于本机 Docker。

如何操作

创建定时任务

想让某个容器定时重启,或定期清理镜像相关资源。

  1. 点击「新建」打开任务编辑弹窗。
  2. 填写名称;选择任务类型(容器启动、停止、重启、镜像更新检测或构建缓存清理)。
  3. 容器类任务多选目标容器;勾选“构建缓存全量清理”这类高风险选项时会明确标注。
  4. 设置计划:使用 5 字段 Cron 表达式,或直接选 @hourly、@daily、@weekly 预设;保存前后端校验名称、类型、目标和 Cron。
  5. 保存后列表显示任务的下次执行时间预览。

结果检查:任务按计划在后端执行;列表的“上次执行”“下次执行”和状态反映真实调度结果。

管理任务与立即执行

临时想跑一次任务,或暂时停用某个计划。

  1. 行内操作依次为:立即运行一次、启动/暂停、历史、编辑、删除。
  2. 「立即执行」只触发一次任务,不改变原调度计划;执行前有一次确认,确认与请求期间防重复操作。
  3. 暂停任务保留全部参数,随时重新启用;编辑则修改类型、目标或 Cron。
  4. 需要批量处理时用框选、复选框或全选当前筛选结果,批量启用、禁用、立即执行或删除;失败项保留选择供重试。

结果检查:任务状态与计划立即更新;批量操作逐项执行并汇总结果,不会因单项失败中断整批。

查看执行历史与失败原因

怀疑某个任务没有按时跑,或想知道上次执行是否成功。

  1. 点击行内「历史」打开右侧历史栏;默认选中最近一条,刷新保留选择,删除或筛选移除当前项后自动回退到第一项。
  2. 按状态灯快速判断:绿色为成功、红色为失败;结合最近失败统计定位反复失败的任务。
  3. 对照执行时间与 Cron 计划确认调度是否符合预期;必要时用「立即执行」验证任务本身是否正常。

结果检查:明确知道每个任务最近一次执行的时间与结果;历史记录保留作为审计依据,不随任务删除而消失。

弹窗与高级功能

任务编辑

打开入口:工具栏「新建」,或行内「编辑」。

定义或修改一个定时任务的名称、类型、目标与计划。

  • 字段:名称、任务类型、目标容器(多选)、Cron 表达式或预设(@hourly/@daily/@weekly)。
  • 校验:名称、类型、目标和 Cron 由后端校验,不合法的 Cron 会被拒绝。
  • 高风险项:构建缓存全量清理属于高风险选项,界面明确标注。

提交或关闭后:保存后新计划立即生效,下次执行时间按新 Cron 计算。

注意:修改目标容器前确认旧容器是否仍存在;任务不会因为目标消失而自动停用。

注意事项

  • 「立即执行」与删除都只确认一次;启停操作保留原任务参数。
  • 应用保护计划的手动触发允许暂停中的策略运行一次,仍受 Go 权益校验约束。
  • 历史栏记录仅显示时间与状态,是审计数据;删除任务不得隐式删除无关日志。