如何从GitLab触发npm脚本作为Cron Jobs定时任务

1. GitLab CI/CD 定时流水线（最原生直接的方案） #

这是GitLab自带的核心功能，完全不需要额外服务，直接和代码仓库绑定就能实现定时任务触发。

• 配置步骤：
  • 在仓库根目录创建 .gitlab-ci.yml 文件，定义专门的流水线阶段
  • 通过规则指定仅定时触发时执行该阶段，选择合适的Node.js镜像完成依赖安装与脚本运行
  • 示例配置：

    scheduled-tasks:
      image: node:20-alpine
      stage: schedule
      rules:
        - if: $CI_PIPELINE_SOURCE == "schedule"
      script:
        - npm install
        - node scripts/daily-maintenance.js  # 替换为你的每日执行脚本
        - node scripts/weekly-update.js      # 替换为你的每周执行脚本
      only:
        - schedules
    

  • 配置完成后，在GitLab仓库的「CI/CD」→「计划」页面新建定时任务，按需设置触发周期（每日、每周等），还能给不同任务配置独立环境变量，灵活区分脚本执行组合
• 优势：零额外运维成本，免费版GitLab即可使用（提供的流水线分钟数足够个人/小型团队场景），日志直接在GitLab流水线记录中查看，方便排查问题

2. 自定义GitLab Runner（适配特殊环境需求） #

如果你的脚本需要特定运行环境（比如依赖系统工具、自定义Node版本），或者共享Runner资源不足，可以自行部署GitLab Runner：

• 用一台轻量服务器（如各类云厂商的基础款轻量应用服务器）安装GitLab Runner并注册到你的仓库
• 依然通过GitLab的CI/CD计划触发任务，但由自定义Runner执行，可完全控制运行环境，不受共享Runner限制

3. GitLab Webhook + 轻量定时服务（过渡方案） #

如果需要逐步迁移，暂时不想全量切换到GitLab CI，可以用这个过渡方案：

• 在GitLab仓库的「设置」→「Webhooks」中新建Webhook，指向一个简单的执行入口（比如用Express写的轻量服务，或者GitLab Pages托管的脚本触发页）
• 用服务器的crontab或云函数的定时触发器，定期调用该Webhook触发脚本执行
• 注意：这个方案不如CI/CD原生简洁，仅适合过渡阶段使用

关键注意事项 #

• Airtables API密钥等敏感信息不要硬编码，存放在GitLab的「CI/CD」→「变量」中，流水线执行时会自动注入
• 不同定时任务可配置独立变量，实现更精细化的脚本参数控制

内容的提问来源于stack exchange，提问作者Dilemmat_Dag