AWX Project Schedules API 详解:rrule 格式规范与项目定时任务实战

发布时间:2026/11/17 14:06:49

AWX Project Schedules API 详解:rrule 格式规范与项目定时任务实战 AWX Project Schedules API 详解rrule 格式规范与项目定时任务实战【免费下载链接】awxAWX provides a web-based user interface, REST API, and task engine built on top of Ansible. It is one of the upstream projects for Red Hat Ansible Automation Platform.项目地址: https://gitcode.com/gh_mirrors/aw/awx导读Project Schedules项目调度是 AWX 中用于让 Project项目按指定时间规律自动触发 SCM 更新等操作的核心能力。本文以 AWX 仓库中的 API 文档模板awx/api/templates/api/project_schedules_list.md为主体骨架系统讲解该端点支持的 GET 列表、POST 创建两种操作并深入剖析其底层rruleiCalendar 循环规则的格式约束、校验逻辑与示例。读完本文你将掌握如何通过 REST API 为 Project 创建定时更新调度并能准确写出通过校验的rrule字符串。端点概览Project Schedules 能做什么在 AWX 中ProjectSchedulesList视图对应路由project_schedules_list注册于 awx/api/urls/project.py#L35re_path(r^(?Ppk[0-9])/schedules/$, ProjectSchedulesList.as_view(), nameproject_schedules_list),也就是说对单个 Project 的调度端点形如GET/POST /api/v2/projects/{id}/schedules/。该视图定义于 awx/api/views/init.py#L1016class ProjectSchedulesList(SubListCreateAPIView): name _(Project Schedules) model models.Schedule serializer_class serializers.ScheduleSerializer parent_model models.Project relationship schedules parent_key unified_job_template resource_purpose schedules of a project关键点在于parent_key unified_job_templateProject 通过UnifiedJobTemplate统一作业模板基类与Schedule模型关联而Schedule模型上的外键unified_job_template见 awx/main/models/schedules.py#L131正是这种关系的落点。因此Project Schedules 本质上是挂在统一作业模板上的定时触发规则其触发的动作是 Project Update项目更新。从模板继承关系看project_schedules_list.md继承自 sub_list_create_api_view.md后者又引入 sub_list_api_view.md从而形成列表 创建两个操作的文档结构。GET列出某 Project 下的所有调度对GET /api/v2/projects/{id}/schedules/发起请求即可检索与所选 Project 关联的全部调度。该列表是标准的分页列表返回的是 ScheduleSerializer 序列化后的字段集合。Schedule模型awx/main/models/schedules.py#L123的核心字段如下字段类型说明unified_job_templateForeignKey关联的作业模板此处为 Project同一模板下调度名唯一unique_together (unified_job_template, name)nameCharField(max_length512)调度名称enabledBooleanField(defaultTrue)是否启用该调度关闭后不再处理rruleTextFieldiCalendar 格式的循环规则字符串即本文重点dtstartDateTimeField计算字段表示首次执行时间大于等于该时间的第一次出现dtendDateTimeField计算字段表示最后一次执行时间之后调度过期next_runDateTimeField计算字段下一次执行时间timezone/until只读属性由rrule推导出的时区与结束时间其中timezone属性awx/main/models/schedules.py#L167会解析rrule中DTSTART的时区信息若为 UTC 直接返回UTC否则通过 zoneinfo 数据库反查时区名。列表默认按next_run降序排列null 值排最后。POST为 Project 创建新调度对同一端点发起POST请求可在指定 Project 下创建新的调度需提交调度相关字段。POST 请求的rrule值必须遵循特定格式且仅允许规则集的一个子集详细约束见下文。关于关联语义需要区分两点由于本端点parent_key unified_job_template创建出的 Schedule 直接与 Project经统一作业模板绑定若父模型字段不同同一文档模板族中的其他子列表端点如job_template_schedules_list、inventory_source_schedules_list参见 awx/api/templates/api/ 下的同名模板会呈现关联/取消关联已有对象的语义而 Project Schedules 走的是直接创建路径。调度一旦创建并启用AWX 的调度器awx/main/scheduler目录会依据next_run到期触发Schedule.get_job_kwargs()awx/main/models/schedules.py#L284会基于调度的prompts_dict()配置拼接作业参数并以launch_type: scheduled、schedule: self的方式标记作业来源。rrule 格式规范AWX 支持的规则子集POST 请求中的rrule必须符合以下格式与约束出自 awx/api/templates/api/_schedule_detail.mdDTSTART必填且必须采用DTSTART:YYYYMMDDTHHMMSSZ格式DTSTART必须为 UTC 时间INTERVAL必填不支持SECONDLY按秒RRULE关键字必须位于规则语句之前BYDAY受支持但不支持带数字前缀的形式如20MOBYYEARDAY与BYWEEKNO不支持每条调度只支持一条RRULE语句COUNT必须小于 1000。这些约束在序列化器层有严格对等的实现。ScheduleSerializer.validate_rruleawx/api/serializers.py#L5687会逐条拒绝缺少DTSTART提示必须以DTSTART:YYYYMMDDTHHMMSSZ开头DTSTART为 naive datetime缺少时区提示DTSTART cannot be a naive datetime出现多个DTSTART提示Multiple DTSTART is not supported未包含rrule:关键字提示One or more rule required in rrule包含exdate:EXDATE not allowed in rrule包含rdate:RDATE not allowed in rrule规则中缺少INTERVAL或INTERVAL不是正整数使用了secondlyBYDAY带数字前缀正则.*?BYDAY[\:\][0-9][a-zA-Z]{2}命中即拒绝COUNT 999提示COUNT 999 is unsupported最终通过Schedule.rrulestr(rrule_value)做整体解析解析失败则报rrule parsing failed validation。校验通过后调度写入数据库。Schedule.rrulestrawx/main/models/schedules.py#L257还封装了自定义解析逻辑先将UNTIL中按 RFC5545 允许的纯日期形式naive强制转换为与DTSTART一致的时区感知形式coerce_naive_until见 awx/main/models/schedules.py#L197再交给底层 rrule 库解析为rruleset为next_run、dtstart、dtend等计算字段提供依据。rrule 示例全集与解读以下是文档中给出的 13 条合法rrule示例覆盖了从分钟级一次性到按年的常见调度需求可直接作为 POST 请求体中的rrule值使用DTSTART:20500331T055000Z RRULE:FREQMINUTELY;INTERVAL10;COUNT5 DTSTART:20240331T075000Z RRULE:FREQDAILY;INTERVAL1;COUNT1 DTSTART:20140331T075000Z RRULE:FREQMINUTELY;INTERVAL1;UNTIL20230401T075000Z DTSTART:20140331T075000Z RRULE:FREQWEEKLY;INTERVAL1;BYDAYMO,WE,FR DTSTART:20140331T075000Z RRULE:FREQWEEKLY;INTERVAL5;BYDAYMO DTSTART:20140331T075000Z RRULE:FREQMONTHLY;INTERVAL1;BYMONTHDAY6 DTSTART:20140331T075000Z RRULE:FREQMONTHLY;INTERVAL1;BYSETPOS4;BYDAYSU DTSTART:20140331T075000Z RRULE:FREQMONTHLY;INTERVAL1;BYSETPOS-1;BYDAYMO,TU,WE,TH,FR DTSTART:20140331T075000Z RRULE:FREQMONTHLY;INTERVAL1;BYSETPOS-1;BYDAYMO,TU,WE,TH,FR,SA,SU DTSTART:20140331T075000Z RRULE:FREQYEARLY;INTERVAL1;BYMONTH4;BYMONTHDAY1 DTSTART:20140331T075000Z RRULE:FREQYEARLY;INTERVAL1;BYSETPOS-1;BYMONTH8;BYDAYSU DTSTART:20140331T075000Z RRULE:FREQWEEKLY;INTERVAL1;UNTIL20230401T075000Z;BYDAYMO,WE,FR DTSTART:20140331T075000Z RRULE:FREQHOURLY;INTERVAL1;UNTIL20230610T075000Z逐条解读第 1 条从 2050-03-31 05:50:00UTC起每 10 分钟触发一次共 5 次COUNT限次适合一次性短周期任务。第 2 条每天一次、只触发 1 次等价于仅执行一次的日调度写法。第 3 条每分钟触发直到UNTIL20230401T075000Z为止UNTIL定终止时间与COUNT二选一。第 4 条每周一、三、五各触发一次BYDAY多值并列。第 5 条每 5 周触发一次仅限周一。第 6 条每月 6 日触发一次BYMONTHDAY指定月内日。第 7 条每月第 4 个星期日触发BYSETPOS4BYDAYSU组合出第几个星期几。第 8 条每月最后一个工作日周一至周五触发BYSETPOS-1表示倒数第一个BYDAYMO,TU,WE,TH,FR限定工作日。第 9 条每月最后一天触发BYSETPOS-1 周一到周日全量。第 10 条每年 4 月 1 日触发。第 11 条每年 8 月的最后一个星期日触发BYMONTH8BYSETPOS-1BYDAYSU典型的某月最后一个星期几写法。第 12 条每周一、三、五触发且受UNTIL截止时间约束UNTIL与BYDAY可同时出现。第 13 条每小时触发一次直到 2023-06-10 07:50:00UTC为止。一个常见的 POST 请求体示例为某 Project 创建每天 07:50 UTC 更新一次的调度形如{ name: nightly-project-update, rrule: DTSTART:20240331T075000Z RRULE:FREQDAILY;INTERVAL1;COUNT1, enabled: true }注意DTSTART是调度的生效起点而非首次执行时间本身首次执行发生在DTSTART之后按规则计算出的第一个时刻即next_run字段所标示的时间。若希望调度长期有效可用UNTIL或省略终止条件若只需要有限次数用COUNT须小于 1000。校验与调试用源码确认边界如果你需要预演某条rrule能产生多少次执行AWX 还提供了SchedulePreviewSerializerawx/api/serializers.py#L5671它接收rrule并复用同一套validate_rrule逻辑返回按该规则计算出的未来执行时间序列适合在创建调度前进行预览验证。提交rrule时若违反上述任一约束API 会返回 400 及具体的错误消息如COUNT 999 is unsupported、Multiple DTSTART is not supported。因此实践中的要点可以归纳为永远以DTSTART:YYYYMMDDTHHMMSSZUTC开头永远在RRULE:之后声明FREQ与INTERVAL避免SECONDLY、BYYEARDAY、BYWEEKNO、带数字前缀的BYDAY、EXDATE、RDATECOUNT控制在 999 以内且不要与UNTIL同时使用一条调度只写一条RRULE语句。文档模板体系这份规范从哪里来project_schedules_list.md本身是 AWX 自动生成 API 文档体系中的一个 Jinja2 模板它继承sub_list_create_api_view.md获得 GET 列表与 POST 创建的结构骨架再通过{% block post_create %}引入 _schedule_list_common.md后者强调POST 请求必须包含符合格式约束的rrule并继续引入 _schedule_detail.md 展开 rrule 的完整格式细则。相同的调度模板块还被schedule_list.md、job_template_schedules_list.md、inventory_source_schedules_list.md复用见 awx/api/templates/api/这意味着本文讲解的 rrule 约束不仅适用于 Project也适用于 Job Template、Inventory Source 等所有挂载调度的资源一通则百通。小结Project Schedules 端点把定时更新项目这一高频运维诉求收敛为一次简单的POST只要提交合法的rruleAWX 就会持久化调度、计算next_run并在到期时自动发起带launch_typescheduled标记的项目更新作业。理解rrule的格式子集UTC 的DTSTART、必填的INTERVAL、受限制的BYDAY/BYSETPOS/COUNT与序列化器层的逐项校验是写出稳定可用的定时任务的第一步也是排查 400 报错的关键依据。【免费下载链接】awxAWX provides a web-based user interface, REST API, and task engine built on top of Ansible. It is one of the upstream projects for Red Hat Ansible Automation Platform.项目地址: https://gitcode.com/gh_mirrors/aw/awx创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/14 21:47:49

JupyterLab 使用与开发全指南:安装、运行、扩展与架构解析

JupyterLab 使用与开发全指南:安装、运行、扩展与架构解析 【免费下载链接】jupyterlab JupyterLab computational environment. 项目地址: https://gitcode.com/gh_mirrors/ju/jupyterlab JupyterLab 是 Project Jupyter 推出的下一代交互式计算环境&#x…

2026/11/17 0:13:30

Kivy Windows 应用打包实战:基于 PyInstaller 生成可执行程序

Kivy Windows 应用打包实战:基于 PyInstaller 生成可执行程序 【免费下载链接】kivy Open source UI framework written in Python, running on Windows, Linux, macOS, Android and iOS 项目地址: https://gitcode.com/gh_mirrors/ki/kivy 本文是 Kivy 官方…

2026/11/14 20:57:44

AI前端面试核心:SSE流式处理与TypeScript类型安全实战

1. 这不是鸡汤,是9月AI前端面试现场的真实战报“最后提醒一次,9月的AI前端面试不用太老实”——这句话不是标题党,是我上周连续面了7家一线大厂和明星创业公司后,在凌晨两点改完第3版简历时写在备忘录里的第一行字。它背后没有情绪…

2026/11/17 14:06:44

低压电工证的考试时间及考前押题攻略,学历不高也能考

低压电工证的考试时间及考前押题攻略,学历不高也能考 你是不是也担心自己学历不高,考低压电工证会卡在报名环节?别急,这事儿我见过太多人担心,但实际操作起来并没有想象中那么难。今天就从 低压电工证的考试时间 说起,结合 考前押题…

2026/11/17 14:06:44

伦教电工证培训机构多久拿证?证书过期了别慌,全攻略在这

伦教电工证培训机构多久拿证?证书过期了别慌,全攻略在这 证书过期了不知道怎么复审延期?很多电工从业者都遇到过这个问题,尤其是那些在三门峡水利工程等一线作业的电工,证书一旦过期,不仅影响工作,还可能面临处罚。所以,及时了解…

2026/11/17 14:06:44

高低压电工证一起年审千万别踩坑 平顶山房建电工怎么操作最靠谱

高低压电工证一起年审千万别踩坑 平顶山房建电工怎么操作最靠谱 证书过期了不知道怎么复审延期?别急,很多电工朋友在拿到高低压电工证后,以为搞定就万事大吉了,结果一不小心就错过了年审时间,导致证书作废,甚至面临被单位追责或停工的风险。尤其是像平…

2026/11/17 14:06:44

工地太忙根本没时间复习考试?低压电工证的考试时间网上查询全攻略

工地太忙根本没时间复习考试?低压电工证的考试时间网上查询全攻略 工地太忙根本没时间复习考试?别急,低压电工证的考试时间网上查询其实比你想象中容易,关键是要掌握方法和节奏。尤其是郑州房建工程一线的电工人员,不仅要应对工期紧张,还要确保自身具备…

2026/11/17 14:01:42

保康电工证怎么考通过率揭秘:外省证能否转回来全攻略

保康电工证怎么考通过率揭秘:外省证能否转回来全攻略 之前考的证在外省能不能转过来?这个问题几乎每个打算考电工证的人都问过,尤其是那些在外省工作、生活,但又希望在本地继续从事电工相关工作的朋友。 保康电工证怎么考 ? 通过率揭秘…

2026/11/16 7:29:52

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/16 5:30:20

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/17 0:02:41

电工证操作和资格证有效期多久?真实经历告诉你怎么复审延期

电工证操作和资格证有效期多久?真实经历告诉你怎么复审延期 证书过期了不知道怎么复审延期,这种情况在电工圈里太常见了。我有个同事,去年刚把低压电工证给弄丢了,直到单位查岗才发现证书已经过期,差点被停工处理。今天就用我真实经历给你讲讲电工证操作…

2026/11/17 0:02:41

机修需不需要电工证 在哪考最靠谱 这些细节必须知道

机修需不需要电工证 在哪考最靠谱 这些细节必须知道 之前考的证在外省能不能转过来?这个问题几乎每个特种作业从业者都问过。特别是像你这样,之前在外省考了证,现在想在本地扎根,或者想换证、换岗的机修人员,最关心的就是【机修需不需要电工证】和【在…

2026/11/17 0:02:41

工地太忙根本没时间复习考试?真实经历告诉你电工证年检步骤是什么

工地太忙根本没时间复习考试?真实经历告诉你电工证年检步骤是什么 工地太忙根本没时间复习考试,我理解你。作为一名刚从焦作工程类院校毕业的学生,我也经历过这种困扰。电工证年检步骤是什么,听起来简单,但实际操作中,很多人因为流程不清楚、资料准备不…

2026/11/17 0:49:41

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/16 3:17:47

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑