如何在Google Sheet或对应Google Drive文件更新时触发Gitlab CI任务

可以通过Google Apps Script结合GitLab API实现「Google Sheet/Drive文件更新时自动触发CI任务」，具体步骤如下：

1. 获取GitLab流水线触发凭证 #

• 进入你的GitLab项目，依次打开「设置」→「CI/CD」→「流水线触发令牌」，生成并记录新的触发令牌。
• 找到项目ID（可在项目主页「设置」→「通用」中查看），并拼接出触发URL，格式为：https://<你的GitLab实例域名>/api/v4/projects/<项目ID>/trigger/pipeline

2. 编写Google Apps Script监听文件变更 #

打开目标Google Sheet，点击「扩展程序」→「Apps Script」进入脚本编辑器，替换默认代码为以下内容（替换占位符为你的实际信息）：

// 监听单元格内容编辑事件
function onEdit(e) {
  triggerGitlabPipeline();
}

// 监听更广泛的文件变更（如插入行列、格式修改等）
function onChange(e) {
  const validChanges = ['EDIT', 'INSERT_ROW', 'INSERT_COLUMN', 'REMOVE_ROW', 'REMOVE_COLUMN'];
  if (validChanges.includes(e.changeType)) {
    triggerGitlabPipeline();
  }
}

// 调用GitLab API触发流水线
function triggerGitlabPipeline() {
  const projectId = '<你的GitLab项目ID>';
  const triggerToken = '<你的GitLab触发令牌>';
  const gitlabUrl = '<你的GitLab实例域名>'; // 例如 'https://gitlab.com'
  const targetBranch = 'main'; // 要触发流水线的分支名

  const url = `${gitlabUrl}/api/v4/projects/${encodeURIComponent(projectId)}/trigger/pipeline`;
  const payload = JSON.stringify({
    token: triggerToken,
    ref: targetBranch
  });

  const options = {
    method: 'POST',
    contentType: 'application/json',
    payload: payload,
    muteHttpExceptions: true
  };

  // 可添加日志用于调试
  const response = UrlFetchApp.fetch(url, options);
  console.log('GitLab API响应:', response.getContentText());
}

3. 配置脚本触发器 #

• 点击编辑器左侧的时钟图标（「触发器」），点击「添加触发器」。
• 配置参数：
  • 选择要运行的函数：根据需求选onEdit（仅监听单元格编辑）或onChange（监听全量变更）
  • 部署来源：Head
  • 事件源：「从电子表格」
  • 事件类型：对应选择「编辑」（onEdit）或「更改」（onChange）
• 保存并完成授权，允许脚本访问网络和电子表格。

4. 验证功能 #

修改Google Sheet的内容或结构，等待几秒后查看GitLab项目的「流水线」页面，确认是否有新的流水线被自动触发。

注意事项 #

• 自托管GitLab需确保防火墙允许Google服务器IP访问你的实例；
• onEdit是简单触发器，执行时间限制为30秒，若API调用较慢建议使用onChange可安装触发器（最长6分钟执行时间）；
• 可在脚本中添加错误捕获逻辑，避免因API调用失败导致脚本中断。

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