如何让GCP Cloud Build同一触发器的构建串行执行？

这确实是开发阶段高频推送代码时容易遇到的头疼问题——并行执行的App Engine部署很容易引发版本冲突、部署状态紊乱等问题，下面分享几个实用的解决方法：

1. 利用Cloud Build触发器的原生并发控制（最简单方案） #

现在Cloud Build已经原生支持触发器的并发限制，直接在控制台就能配置：

• 打开Cloud Build的触发器页面，找到你需要调整的触发器，点击编辑
• 在"高级设置"里找到并发控制选项，选择「仅允许一次运行一个构建」
• 保存设置后，同一触发器触发的构建就会自动串行执行：新的构建会进入排队状态，直到前一个构建完成（无论成功或失败）

这个方法不需要额外编写代码，完全依赖GCP原生功能，适合大多数常规场景。

2. 自定义存储锁机制（适合复杂自定义场景） #

如果需要更灵活的控制逻辑，比如跨触发器的串行控制，可以借助Cloud Storage实现简单的锁机制，在构建步骤中加入锁检查：
在你的cloudbuild.yaml里添加锁相关步骤：

steps:
  # 尝试获取构建锁，利用mkdir原子操作实现抢占
  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
    entrypoint: 'bash'
    args:
      - '-c'
      - |
        while true; do
          if gsutil mkdir gs://your-lock-bucket/build-lock 2>/dev/null; then
            echo "获取锁成功，开始构建"
            break
          fi
          echo "锁已被占用，等待30秒后重试..."
          sleep 30
        done
  # 你的核心构建/部署步骤
  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
    entrypoint: 'gcloud'
    args: ['app', 'deploy']
  # 释放锁，确保即使构建失败也能清理锁资源
  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
    entrypoint: 'bash'
    args:
      - '-c'
      - 'gsutil rm -r gs://your-lock-bucket/build-lock || true'

注意要替换your-lock-bucket为你自己的存储桶名称，核心是利用Cloud Storage的mkdir原子性来实现锁的抢占。

3. 通过Cloud Tasks实现串行队列编排 #

如果需要更精细的任务调度（比如延迟执行、失败重试），可以把构建请求导入Cloud Tasks队列，设置队列的并发数为1，实现串行执行：

• 创建一个Cloud Tasks队列，设置最大并发任务数为1
• 修改原触发器的行为：不直接触发Cloud Build，而是触发一个Cloud Function或者HTTP服务，该服务将构建请求添加到Cloud Tasks队列
• 队列中的任务再调用Cloud Build API触发构建

这样所有的构建请求都会进入串行队列，按顺序执行，适合需要批量调度或复杂逻辑的场景。

最佳实践提示 #

• 优先使用原生的触发器并发控制，减少维护成本
• 如果使用自定义锁，一定要确保构建失败时也能释放锁（比如上面的|| true避免删除失败导致构建失败）
• 对于App Engine部署，也可以结合gcloud app deploy --version指定唯一版本号，减少并行部署的冲突风险，但串行执行仍是更彻底的解决方案

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