on 这一段,并说出定时任务为什么不会准点、以及公开仓库的定时任务为什么可能自己停掉。
| 事件 | 什么时候发生 | 典型用途 |
|---|---|---|
push | 有人往仓库推了提交 | 每次提交都跑检查 |
pull_request | 合并请求被打开、更新、重新打开 | 合并前拦住问题 |
schedule | 到点(用 cron 写) | 定时抓数据、定时体检 |
workflow_dispatch | 有人手动点一下,或在别处调接口 | 不常跑、但要能随时跑的任务 |
workflow_call | 被另一个工作流调用 | 把一段流程做成可复用的积木 |
release / repository_dispatch | 发布了版本 / 被外部系统点名触发 | 发版打包、和别的系统对接 |
可以同时写多个:on: [push, workflow_dispatch] 表示「推送时跑,我也能手动跑一次」——
给定时任务加上手动触发,是最省事的调试习惯。
on:
push:
branches: [master] # 只在这些分支被推送时跑
paths: ["src/**", "package.json"] # 只有这些文件变了才跑
pull_request:
types: [opened, synchronize, reopened]
branches / paths 是白名单:没命中就不触发,能省下大量无谓的运行。paths 的坑:只改文档不触发是好事;但如果这条流程同时也是「必须通过」的合并门槛,不触发就等于这道门根本没上锁。pull_request 默认只在「打开 / 更新」时跑;types 可以细化到「重新打开」「打上标签」等。on:
schedule:
- cron: "30 0 * * *" # UTC 每天 00:30(北京时间 08:30)
*/6 表示每 6 个单位一次。on:
workflow_dispatch:
inputs:
env:
description: "在哪个环境上跑"
default: "staging"
options: ["staging", "prod"]
这样在仓库的 Actions 页面会出现一个「Run workflow」按钮,还能先填两个参数。
输入值在流程里用 ${{ inputs.env }} 取。
它不解决调度,解决的是「人想跑就跑」 —— 调试、补跑、给非开发同事一个入口,都靠它。
三题自测,每题只有一个正确选项;选完立刻看到解释。
1. 想让它「北京时间每天 9:00」跑,cron 该写几点?
对。9 - 8 = 1,cron 写 0 1 * * *。平台只看 UTC,不会替你做时区换算。
2. 公开仓库的定时任务为什么可能自己停掉?
对。官方口径是连续 60 天没有仓库活动就暂停定时任务,推一次提交即可唤醒 —— 所以「悄悄停掉」是很常见的排查盲区。
3. 给一条定时流程同时加上手动触发,好处是什么?
对。定时流程最难受的就是「想验证一次得等到明天」;加 workflow_dispatch 之后随时能跑 —— 顺带还能给不写代码的人一个入口。