GCP Cloud Build：如何读取触发构建的Pub/Sub主题数据

当Cloud Build被Pub/Sub触发时，系统会自动把Pub/Sub的消息数据注入到构建环境变量里，核心是TRIGGER_EVENT这个JSON格式的环境变量——它包含了触发事件的所有信息，其中pubsubMessage.data字段就是Base64编码后的原始消息内容。

具体实现方法 #

1. 在cloudbuild.yaml中解析消息 #

直接在构建步骤里读取TRIGGER_EVENT，解码其中的Base64数据即可。下面是完整的示例配置：

steps:
  - name: 'gcr.io/cloud-builders/gcloud'
    entrypoint: 'bash'
    args:
      - '-c'
      - |
        # 提取Pub/Sub的Base64编码消息
        EVENT_DATA=$(echo "$TRIGGER_EVENT" | jq -r '.pubsubMessage.data')
        # 解码Base64得到原始内容
        DECODED_DATA=$(echo "$EVENT_DATA" | base64 -d)
        echo "解码后的消息内容: $DECODED_DATA"
        # 把数据写入共享目录，供后续步骤使用
        echo "$DECODED_DATA" > /workspace/pubsub_msg.txt

2. 关键注意点 #

• 确保构建镜像带jq工具：上面用的gcr.io/cloud-builders/gcloud默认包含jq，要是用其他镜像，得先安装jq（比如apt-get install -y jq）。
• 必须解码Base64：pubsubMessage.data是Base64编码的，不解码读出来是乱码。如果原始消息是JSON格式，解码后还能继续用jq解析字段，比如echo "$DECODED_DATA" | jq -r '.key'。
• 跨步骤共享数据：把解码后的数据写入/workspace目录，这个目录在所有构建步骤间是共享的，后续步骤直接读文件就行。

3. 测试验证 #

你可以手动发一条测试消息到触发主题，然后看Cloud Build日志确认是否成功读取：

gcloud pubsub topics publish YOUR_TRIGGER_TOPIC --message '{"action": "deploy", "env": "staging"}'

查看构建日志，应该能看到输出的解码后JSON内容。

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