GitHub Actions定时任务配置完全指南:从Cron语法到实战示例

你好,我是悦创。

博客网站:https://blog.bornforthis.cn/

本教程将详细讲解如何在GitHub Actions中配置定时任务(Scheduled Tasks),帮助你掌握 Cron 表达式的编写规则和实际应用场景。

一、定时任务基础配置

1.1 核心语法结构

yaml 复制代码
on:
  schedule:
    - cron: "分 时 日 月 周"

1.2 参数解析

组件 取值范围 说明
0-59 分钟
0-23 小时(UTC时间)
1-31 月份中的日期
1-12 或 JAN-DEC 月份
0-6 或 SUN-SAT 星期(0=周日)

二、Cron表达式详解

2.1 特殊字符说明

符号 示例 作用
* * * * * * 任意值
, 0,30 * * * * 多个值
- 0-5 * * * * 范围值
/ */15 * * * * 间隔值

2.2 常用配置模板

yaml 复制代码
on:
  schedule:
    # 每5分钟(GitHub最小间隔)
    - cron: "*/5 * * * *"
    
    # 每日UTC时间0点
    - cron: "0 0 * * *"
    
    # 每周一北京时间上午8点
    - cron: "0 0 * * 1"
      timezone: Asia/Shanghai
    
    # 每月1号正午执行
    - cron: "0 12 1 * *"

三、高级配置技巧

3.1 时区设置

yaml 复制代码
- cron: "0 8 * * *"
  timezone: Asia/Shanghai  # 支持IANA时区数据库格式

3.2 分支过滤

yaml 复制代码
on:
  schedule:
    - cron: "0 0 * * *"
  branches:  # 限定触发的分支
    - main
    - release/*

3.3 多任务配置

yaml 复制代码
on:
  schedule:
    - cron: "0 9 * * 1-5"   # 工作日早9点
    - cron: "0 18 * * 1-5"  # 工作日晚6点
    - cron: "0 12 * * 0"    # 周日中午12点

四、注意事项

  1. 执行延迟:GitHub Actions的定时任务可能有1-10分钟的延迟
  2. 频率限制
    • 公共仓库:每月2000分钟免费额度
    • 私有仓库:每月500分钟免费额度
  3. 日志查看 :执行记录可在仓库的 Actions 标签页查看
  4. 表达式验证 :推荐使用 crontab.guru 调试表达式

五、实战应用场景

5.1 自动化测试

yaml 复制代码
name: Daily Test
on:
  schedule:
    - cron: "0 0 * * *"
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - run: npm test

5.2 数据备份

yaml 复制代码
name: Weekly Backup
on:
  schedule:
    - cron: "0 3 * * 6"  # 每周六凌晨3点
jobs:
  backup:
    runs-on: ubuntu-latest
    steps:
      - name: Backup database
        run: ./scripts/backup.sh

5.3 定时通知

yaml 复制代码
name: Morning Reminder
on:
  schedule:
    - cron: "0 9 * * 1-5"  # 工作日早9点
jobs:
  notify:
    runs-on: ubuntu-latest
    steps:
      - uses: actions-slack@v3
        with:
          payload: |
            {
              "text": "每日站会时间到!"
            }

SEO优化提示:本文包含高频搜索关键词「GitHub Actions定时任务」「Cron配置指南」「自动化工作流」,建议在相关技术社区和博客平台发布时保留标题结构。

相关推荐
10岁的博客5 小时前
GitHub宕机自救指南技术文章大纲
github
花椒和蕊5 小时前
记录git报错ssh: connect to host github.com port 22: Connection timed out,已解决
git·ssh·github
CoderJia程序员甲5 小时前
GitHub 热榜项目 - 日榜(2025-08-28)
ai·github·开源项目·github热榜
atwednesday6 小时前
git提交规范
github
顾辰逸you7 小时前
git打包流程
前端·github
早睡早起头发多7 小时前
Git 高级协作技巧:储藏与变基实战指南🛠️
github
wayhome在哪7 小时前
Git 合并:Merge 还是 Rebase?
git·面试·github
掘金安东尼9 小时前
JavaScript 接下来要加啥新功能?9个特性!
前端·javascript·github
喷火龙8号1 天前
一次完整的 Git 提交撤销与代码恢复经历
github
努力犯错玩AI1 天前
微软开源TTS模型VibeVoice:一键生成90分钟超长多角色对话,告别机械音!
人工智能·后端·github